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ABSTRACT 

/ 

' This  report  details  the  development  of  a computer-aided 
design  program  for  continuous  and  discrete  control  systems. 

The  program  described  is  fully  interactive  and  provides 
complete  error  detection,  abort  protection,  and  several 
levels  of  user  assistance.  In  addition  to  digital  and 
continuous  time  response,  frequency  response,  and  root  locus, 
the  program  allows  block  diagram  manipulation,  state-space 
analysis,  and  a variety  of  continuous  to  digital  transformations. 
Built-in  polynomial,  matrix,  and  scientific  calculators  are 
also  provided.  A user's  manual  and  programmer's  guide  are 
included  to  aid  in  further  development  of  the  program. 
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AN  INTERACTIVE  COMPUTER-AIDED  DESIGN  PROGRAM 
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FOR  DIGITAl,  AND  CONTINUOUS  CONTROL  SYSTEM 
ANALYSIS  AND  SYNTHESIS 

I . Introduction 

Guidance  and  control  Is  a field  characterized  by 
problems  which  require  a lot  of  computation.  Many  of  these 
computations  are  conceptually  simple,  but  require  a lot  of 
time  and  effort  to  perform.  As  a result,  people  working  in 
the  field  spend  a lot  of  time  doing  routine  calculations 
instead  of  concentrating  on  problems  worthy  of  their  skill  and 
training.  The  obvious  solution  is  to  use  a computer  to 
perform  these  tasks . 


Back<*round  and  Problem  Statement 

Many  pomputer -aided  design  programs  have  been  written 
with  the  intention  of  reducing  the  computational  effort 
required  to  solve  guidance  and  control  problems.  (Refs.  2,  3, 

4,  5,  6,  7,  8,  9,  14,  22,  28,  29,  34,  35).  Most  perform  the 
functions  for  which  they  were  intended  very  well . Unfortunately 
many  suffer  from  poorly  designed  user  interfaces  which,  while 
not  affecting  their  actual  results,  have  seriously  impaired 
their  efficient  use. 

To  point  out  this  problem,  some  of  the  more  frustrating 
experiences  which  Inevitably  occur  when  using  computer-aided 
design  programs  are  given  on  the  next  page.  Not  all  programs 
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suffer  from  each  of  these  problems,  but  few  avoid  them  all. 

(1)  The  prop.rarn  terminates  abruptly  because  the  user 
accidentally  typed  an  Illegal  character.  All 
information  typed  is  lost  and  the  user  must  start 
over . 

(2)  In  the  middle  of  a long  string  of  input  data  the 
user  Inadvertantly  entered  an  incorrect  value.  The 
program  runs  its  course  producing  meaningless  output 
and  when  it  terminates,  the  user  must  start  over. 

(3)  The  program  terminates  abruptly  because  an  incorrect 
data  value  caused  some  internal  equation  to  become 
computationally  unsolvable.  All  current  data  is 
lost  and  the  user  must  start  over. 

(4)  The  program  actually  operates  correctly,  producing 
the  desired  results  and  terminating  normally.  The 
user  then  wants  to  try  another  run  with  only  one 
small  change  in  the  input.  The  user  must  retype  all 
of  the  input  data . 

(5)  The  user  finally  obtains  the  needed  results  from  a 
particular  program.  He  then  wishes  to  perform  a 
different  function  on  the  same  set  of  data.  He 
starts  another  program  and  must  retype  his  input  data 
again,  this  time  using  a different  format. 

It  is  this  continued  typing  and  retyping  of  input  data 
that  makes  current  computer-aided  programs  difficult  to  use. 

If  computer-aided  design  is  to  reach  its  full  potential,  some 
effort  must  be  made  to  reduce  this  workload  and  to  protect 
users  from  their  own  mistakes . 

The  problem  is  that  computer-aided  design  programs  are 
usually  written  only  as  they  are  needed  to  solve  some 
particular  set  of  problems  currently  of  interest.  Since  the 
programmer  is  only  writing  the  program  as  a quick  means  to 
some  other  end,  he  spends  very  little  time  in  perfecting  the 
program  Itself.  He  Is  generally  satisfied,  because  of  his 


own  time  constraints,  if  the  prof,ra:n  just  accents  data  and 
outputs  correct  answers.  Few  people  have  time  to  make 
prop.rams  onerate  conveniently. 

As  a result,  there  is  a lot  oF  computational  assistance 
available  today  but  little  of  it  is  easy  to  use.  Savings 
in  computation  time  whicii  should  be  realized  are  lost  in  tlie 
effort  of  operating  the  programs  themselves. 

Statement  of  Purnose 

If  computer-aided  design  software  is  to  be  improved,  it 
must  be  designed  with  tw’o  equally  important  goals  In  mind: 

(1)  It  must  be  capable  of  solving  whatever  class  of  problems 
Is  of  interest,  and  (2)  it  should  require  as  little  effort 
from  tiie  user's  standpoint  as  possible.  Only  if  these  goals 
are  accomplished  together  will  users  be  able  to  obtain  all 
the  benefits  of  computer-aided  design. 

The  purpose  of  this  investigation  is  to  develop  a 
computer-aided  design  program  which  will  provide  all  of  these 
benefits  to  people  working  in  the  field  of  guidance  and  control. 
To  this  end  the  following  goals  have  been  determined* 

(1)  To  consolidate  as  many  existing  computer-aided  design 
programs  as  possible  into  one  package  so  tliat  users 
can  realize  the  benefits  of  a standard  input  format, 
the  convenience  of  having,  every  function  at  their 
fingertips,  and  the  efficiency  of  a unified  data 
structure  where  input  does  not  have  to  be  retyped 
for  every  phase  of  a problem. 

(2)  To  create  new  program  functions  in  areas  where 
currently  existing,  tools  are  unavailable  or  inadequate. 
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(3)  To  desipn  and  develop  an  efficient  user  interface 
which  gives  the  user  complete  control  of  the  program 

and  its  data  with  a minimum  amount  of  typing.  j 

(4)  To  develop  a program  structure  which  is  easy  to  learn, 
maintain,  modify,  and  extend. 
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Approach 

The  approach  used  in  this  investigation  will  be  one  of 
uniform,  modular,  standardized  top-down  design.  While  this 
approach  is  defined  in  detail  in  Chapter  IV,  the  basic  idea 
is  a simple  four  step  process « 

(1)  An  overall  picture  is  first  obtained  of  what  the 
program  is  to  do  and  how  it  is  to  operate  as  a single 
large  "black  box."  This  is  accomplished  by  essentially 
attempting  to  write  the  user's  m.anual  first  so  that 
every  function  the  program  is  to  perform  is  clearly 
defined . 

(2)  The  single  black  box  defined  in  step  1 is  then 
broken  down  into  several  smaller  boxes  (modules)  each 
of  which  must  then  be  defined  as  thoroughly  as  the 
original  box. 

(3)  Step  2 is  repeated  on  each  new  set  of  boxes  until 
eventually  a level  is  reached  where  each  module 
performs  only  a single  elementary  function. 

(4)  Finally,  the  elementary  modules  are  constructed  and 
tested  individually  usinp.  a standard  programming,  style 
and  then  combined  until  eventually  the  original  black 
box  has  been  realized. 

Thus,  the  program  is  designed  "from  the  top  down"  to 
obtain  a uniform  final  structure  but  built  "from  the  bottom  up." 
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Constraints 

The  following  constraints  were  placed  on  this  investigation 
either  by  the  resources  available  or  the  nature  of  the  problem 
itself  j 
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(1)  The  r’oal  s must  bo  sufficiently  limited  to  allov 
accomplishment  by  a single'  individual  in  a 15  month 
period  oi'  time. 

(2)  The  codin;;  must  he  i)erfor:iied  usinp,  the  fOTTR-W  IV 
computer  lan/;uap,e  because  most  ol  tlie  currently 
existinp,  programs  vdsich  are  to  be  included  in  tiie 
overall  nackape  liavo  been  written  in  this  lanp.ua-’c. 
(Refs.  2,3/i.5,b.7.8,V,l:'i,22,2S,29,31,35)  and  it  is 
r.enerallv  accs'pted  as  a standard  in  the  fic.'ld. 

(Ref.  18) 

(3)  The  prop, ram  is  constrained  to  operate  in  less  than 
60,  QUO,  words  of  core  mfsnory  by  the  computer  syste.m. 
(Ref.  ^1) 

(A)  Tlie  propram  :nust  function  reliably  producing  correct 
results . 


Suimnary  of  Oesi  rn  ITulosonhy 

Throughout  the  design,  the  following  philosopiiy  will  bo 
followed:  "the  user's  time  is  more  valuable  tiian  ttio  compute's 

time."  i\i'hile  it  is  true  that  a computer's  time  is  mo?-e  expensive 
on  a minute  f or  minute  basis,  it  is  much  cheaper  on  a problem 
for  probl om  basis  (because  of  its  speed).  This  is  the  only 
fair  moans  of  comparison  since  the  object  is  to  solve  a certain 
number  of  problems  at  minimum  expense,  not  to  use  up  a certain 
amount  of  time  at  minimum  expense!  Therefore,  the  prime 
directive  of  this  study  will  be:  When  a choice  must  bo  made, 
minimizing  user  time  must  take  precedence  over  minimizing 
computer  time.  No  effort  will  bo  spared  to  simplify  the  use  of 
routines  which  are  needed  by  so  many  people  so  much  of  the  time. 
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1 1 . Development  of  Initial  Prop:ram  Functions 


As  mentioned  in  the  introduction,  the  objective  of  this 
design  study  is  to  develop  a computer  propram  which  is  both 
fully  interactive  and  capable  of  solving  the  problems  of 


interest.  This  chapter  develops  the  requirements  for  the 
second  of  these  goals.  The  first  will  be  discussed  in  Chapter 
III. 

The  ultimate  motivation  behind  this  investigation  is  the 
desire  to  obtain  a tool  which  is  capable  of  performing  every 
computation  needed  in  the  field  of  guidance  and  control.  To 
demonstrate  the  magnitude  of  this  undertaking,  the  following 
list  has  been  compiled.  ^Vhile  the  list  is  by  no  means  complete. 
It  is  representative  of  the  kinds  of  functions  which  are  needed. 
A discussion  of  why  these  functions  are  needed  is  beyond  the 
scope  of  this  report,  but  the  fact  that  they  are  needed  is 
documented  (as  indicated  below)  in  more  than  one  reference  in 
the  literature. 

Needs  for  Computer  Assistance  in  Guidance  and  Control 

(1)  Root  locus  in  the  s,  z,  w,  and  w'  planes.  (Refs.  13, 

20,  21,  27,  28,  33) 

(2)  Discrete  and  continuous  time  response . (Refs.  14,  20, 

21,  23,  27,  28,  30) 

(3)  Discrete  and  continuous  frequency  response.  (Refs.  20, 
21,  23,  27,  28,  30) 

(4)  Discrete,  continuous,  and  stochastic  system 
simulations.  (Refs.  20,  23,  26,  30) 

(5)  Power  spectrum  analysis . (Refs.  25,  30) 
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(6) 

Sensitivity  analysis . (Refs.  20,  21,  27,  28) 

( 

(7) 

Relative  and  global  stability  analysis.  (Refs.  20,  21) 

(8) 

Polynomial  operations  including  addition,  subtraction,  > ' 

multiplication,  division,  factorization,  and 
expansion.  (Refs.  13,  14,  20,  21,  23,  27,  28,  30) 

* 

r. 

• i 

(9) 

Matrix  operations  including j 

Addition,  subtraction,  multiplication,  inversion, 
and  transposition. 

Computation  of  adjoint,  cofactor,  and  determinant. 

Similarity  transformations  and  rank  determination. 

Eigenvalue  and  eigenvector  calculation. 

State  transition  and  resolvent  matrix  computation. 
DiagonAlization  and  Hermite  normal  form  reduction. 

(10) 

Discrete  to  and  from  continuous  system  representation 
transformations  and  approximations.  (Refs.  14,  23,  ! 

25,  30)  . ! 

(11) 

State-space  model  to  transfer  function  model  ' i 
conversion.  (Refs.  13,  14,  20,  21,  23,  25,  27,  28,  i 
30,  34) 

(12) 

Transfer  function  conversion  to  state- space  canonical  ! 

forms.  (Refs.  14,  20,  21,  23,  27,  28,  30,  34)  ' , 

(13) 

Conversion  between  state-space  canonical  forms. 

(Refs.  14,  20,  23,  27,  34) 

, ( 

(14) 

Continuous  filter  design  Including  Butterworth,  ! 
Chebyshev,  elliptic,  and  other  realizations.  (Refs.  14,  1 
23,  25,  30)  j 

(15) 

Digital  filter  design  including  finite  (FIR)  and  j 

infinite  (HR)  impulse  response  realizations. 

.(Refs.  14,  23,  25,  30)  1 

\ 

(16) 

Signal  processing  and  analysis  including  convolution,  ' 

Fourier  transformation,  integration,  differentiation, 
correlation,  and  RMS  analysis.  (Refs.  14,  23,  25,  30)  ; 

■ 

(17) 

Classical  control  design  including  gain,  lead,  and  j j 

lag  compensation  and  Guillemln-Truxal  techniques. 

(Refs.  20,  21,  27) 

(18) 

Modern  control  including  state-variable  feedback,  i 
modal  control,  and  observer  design.  (Refs.  20,  21,  j 
27,  34) 

(19) 

Direct  digital  design  including  minimal  prototype, 
dead-beat  response,  windowing,  frequency  sampling 
and  mean-square  error  teclmlques.  (Refs.  14,  23, 

25,  30) 

c 

* 

(20) 

Optimal  control  design  including  solution  of  the  ' 

Rlcattl  equation  and  performance  index  adjustment. 

(Refs.  20,  24,  2») 
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(21)  Non-linear  control  design  including  phase  plane 
methods,  linearization,  and  curve  fitting  techniques. 
(Refs.  20  21,  22) 

(22)  Stochastic  control  analysis  and  Kalman  filter  design. 
(Refs.  21,  26) 

(23)  Partial  fraction,  continued  fraction,  and  power 
series  expansions.  (Refs.  14,  20,  21,  22,  23,  27,  28) 

(24)  Equation  solution  including  ordinary  and  partial 
differential  equations  and  sets  of  linear  algebraic 
equations.  (Refs.  22,  28) 

(25)  Word  length,  quantization,  and  sampling  rate  analysis. 
(Refs.  14,  23,  30) 

(26)  Block  diagram  manipulation  including  addition  and 
multiplication  of  transfer  functions,  and  the  closing 
of  unity  and  non-unity  feedback  loops.  (Refs.  13, 

14,  20,  21,  23,  27) 


Determination  of  Priorities 

Because  of  the  size  of  the  above  list,  this  study  cannot 
hope  to  accomplish  everything.  Therefore,  it  is  necessary  to 
select  which  subset  of  these  functions  should  be  developed 
first.  Such  a selection  should  give  priority  to  functions 
which  are  of  greatest  and  most  general  use  in  the  field,  especially 
those  which  would  be  useful  in  performing  other  higher  level 
functions.  This  section  describes  how  priorities  were  assigned 
and  what  functions  were  selected  for  implementation  during 
this  investigation. 

To  aid  in  assigning  priorities  which  would  develop  the 
most  general  and  widely  useful  functions  first,  a survey  was 
taken  of  textbooks  in  the  field.  (Refs.  13,  14,  20,  21,  22,  23, 

24,  25,  26,  27,  28,  30,  34).  A priority  was  assigned  to  each 
function  in  relation  to  (1)  the  number  of  different  areas  of 
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control  (di/'ital,  continuous,  stocfiastic,  optimal,  etc.)  in 
which  it  was  uscxi  and  (2)  the  frequency  with  which  it  was 
needed  in  each  arc^a.  No  Formal  scorinp,  procedure  was  used, 
but  each,  function  was  evaluated  accordinp,  to  the  following 
p.eneral  guidelines; 

(1)  Computations  which  were  rec^uired  extensively  in  more 
than  one  area  were  piven  top  nriority  witfi  those 
encountered  most  often  beinp  considered  first.  Not 
only  are  such  functions  the  most  p,onorally  useful, 
but  they  may  often  serve  as  buildin/'  blocks  lor  more 
comnlex  functions. 

(2)  .Spe-cial ized  functions  that  wore  considered  fundamental 
to  a particular  area  of  study  were  pivon  tlio  second 
hiphost  priority. 

(3)  'lore  advanced  procedures  needed  for  serious  work  in 
the  field  were  selected  next.  \t  this  noint  the 
functions  became  so  specialized  that  nriorities  hati 
to  bo  assigned  based  on  the  needs  of  individuals 
alr'eady  usinp,  the  prop.rara  as  it  was  beinp,  dcvcloned. 

(4)  State-of-the-art  computational  techniques  siiould  be 
added  to  the  complete  packap.o  as  tliey  are  developf'd. 

Usinp,  those  p,uidelines,  the  following  areas  were  selectf'd 
as  beinp  essential  first  level  elements  of  a comprehensive  _ 
computer  prop, ram  for  puidance  and  eontrol  work; 

(1)  Root  locus  analysis. 

(2)  Discrete  and  continuous  time  response. 

(3)  Discrete  and  continuous  frequency  response. 

(4)  Block  diapram  manipulations. 

(5)  Polynomial  operations. 

(6)  'latrix  operations. 

(7)  Scalar  operations. 

(8)  Classical  control  design  techniques. 

(9)  Modern  control  design  techniques. 

(10)  Continuous  to  discrete  transformations. 


9 


./-’a 


I 


I 


j 

( 


I 

r, 

u 


( 


t 

i 


These  are  the  features  that  will  be  Included  in  the 
program  developed  during  this  investigation.  In  addition  to 
being  a useful  set  of  functions  themselves,  they  are 
sufficiently  general  to  allow  development  of  a program 
structure  which  can  accomodate  any  other  function  which  may 
eventually  be  added.  In  other  words,  they  provide  a basis  on 
which  a data-base  and  an  interactive  user  interface  for  the 
final  program  can  be  developed  and  tested.  Development  of  the 
data  base  is  the  topic  of  the  next  section.  The  interactive 
user  interface  will  be  discussed  in  Chapter  III. 

Discussion  of  Data-base  Variables  Needed 


4 1 

1 1 
I : 


In  order  to  realize  the  goal  of  a unified  expandable 
program  where  all  routines  use  the  same  set  of  input  data,  it 
is  necessary  to  develop  a data-base  of  variables  in  which 
this  information  can  be  stored,  \7hile  the  actual  realization 
of  this  data-base  will  be  covered  in  Chapter  IV,  this  section 
discusses  what  kinds  of  variables  may  be  necessary  to  store  all 
of  the  information  needed  by  the  program. 

The  most  commonly  needed  piece  of  information  for  the 
functions  to  be  realized  is  the  transfer  function.  Root  locus, 
time  response,  and  frequency  response  routines  all  require 
Input  in  this  form  as  do  many  of  the  convent ioanl  control 
system  design  techniques.  Block  diagram  manipualtions  are, 
by  definition,  performed  on  transfer  functions. 

A transfer  function  is  represented  either  as  a ratio  of 
polynomials  or  in  factored  form  as  a collection  of  poles, 
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zeros,  and  gain  constants.  Thus,  to  represent  a transfer 
function  in  the  common  data-base,  provision  must  be  made  to 
store  its  numerator  and  denominator  polynomial  coefficients, 
the  real  and  imaginary  parts  of  its  poles  and  zeros,  and 
whatever  gain  constants  may  be  associated  with  it. 

The  number  of  transfer  function  storage  locations  that 
should  be  provided  is  dependent  upon  the  single  function  which 
uses  the  most  of  them,  which  in  this  case  is  the  set  of  block 
diagram  manipulations.  Since  these  manipulations,  in  general, 
operate  on  two  transfer  functions  to  produce  a third,  at  least 
three  storage  locations  should  be  provided.  An  additional 
location  for  storing  intermediate  results  would  also  be  very 
useful,  bringing  the  recommended  minimum  number  of  transfer 
functions  to  four.  Naturally,  if  space  permits,  additional 
transfer  functions  could  always  be  used  to  improve  the 
versitility  of  the  program. 

Using  similar  reasoning,  at  least  four  arrays  of  polynomial 
coefficients  should  be  provided  to  allow  easy  execution  of 
polynomial  operations.  While  such  arrays  could  use  the  same 
locations  in  which  transfer  function  numerators  or  denominators 
are  stored,  it  is  recommended  (if  space  permits)  that  they  be 
kept  separate  to  minimize  user  confusion.  Also,  since 
corresponding  to  each  polynomial  there  is  a set  of  polynomial 
roots,  it  may  be  beneficial  to  provide  storage  locations  for 
them.  This  would  allow  users  to  refer  to  polynomials  in 
either  factored  or  unfactored  form. 
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Hitrlcxis  form  another  larp.o  class  of  variables  for  wiiieh 


. i 


i 

\ 


f 

I 

4 


( 


1^ 


( 


storap^e  locations  iroast  be  provided.  At  least  five  matrix 
arrays  are  needed  to  rcoresent  a system  in  state- space 
notation  including:  system  .input,  output,  direct  transmission, 
and  state  variable  feedback  matrices  If  both  discrete  and 
continuous  systems  are  to  be  represented  siimiltaneously , an 
additional  two  arrays  will  bo  needed  to  store  the  discrete 
system  and  discrete  input  matrices  These  seven  tmatrix 
locations  will  probably  have  to  double  as  w'orkinp,  rep.istors 
for  matrix  arithmetic  due  to  storage  limitations. 

Finally,  each  prop,ram  in  the  packap.e  will  undoubtably  have 
its  own  set  of  scalar  variables  to  use.  Provision  should  be 
made  to  include  such  variables  as  they  become  necessary. 

It  must  be  remembered  that,  while  the  variables 
recommended  above  are  sufficient  for  the  needs  of  tiie  routines 
developed  in  this  study,  it  may  be  necessary  to  provide  new 
storage  locations  as  new  features  are  added.  For  example, 
when  signal  processing  routines  are  included,  it  may  be 
necessary  to  add  locations  for  storage  of  number  sequences, 
and  so  on.  Whatever  data  structure  is  developed  should  bo 
flexible  enough  to  allow  continued  expansion  as  the  program 
grows . 
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in.  Development  of  the  Interactive  User  Interface 


The  second  major  goal  of  this  Investigation  Is  to  make  a 
program  which  Is  not  only  computationally  powerful,  but  also 
very  easy  to  use.  This  requires  that  a user  be  able  to  specify, 
with  a minimum  amount  of  tvplnr..  exactly  which  operations  the 
program  Is  to  perform  and  what  data  It  Is  to  use.  The  following 
list  defines  the  features  that  a program  must  have  If  a 
truely  efficient  user  Interface  Is  to  be  achieved i 

(1)  Protection  against  premature  program  termination  due 
to  Input  errors. 

(2)  Ability  to  recover  from  Input  errors  without  starting 
over. 

(3)  Ability  to  selectively  display  the  value  of  any 
program  variable  at  any  time. 

(4)  Ability  to  selectively  modify  the  value  of  any 
variable  at  any  time. 

(5)  Ability  to  transfer  the  contents  of  any  one  variable 
to  any  other  variable  without  manually  retyping  the 
data . 

(6)  Ability  to  use  the  output  of  one  program  function  as 
the  Input  to  another  without  manually  retyping  the 
data. 

(7)  Ability  to  provide  help  to  the  user  at  any  time, 
especially  when  Input  requested  by  the  program  Is  not 
understood . 

(8)  Ability  to  selectively  list  the  options  available  to 
the  user  whenever  needed. 

(9)  Ability  to  stop  the  program  and  restart  It  later 
without  losing  any  data. 

(10)  Ability  to  abort  a command  without  terminating  the 
entire  program. 

(11)  Ability  to  assume  different  modes  of  operation  to 
tailor  fit  the  program's  performance  to  the  user's 
preferences . 
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(12)  Ability  to  control  the  flow  of  the  program  from 

function  to  function  with  complete  freedom  and  as 

little  effort  as  possible.  ^ 

In  short,  an  efficient  user  interface  is  one  which 

requires  a minimum  amount  of  typing  by  the  user  while  providing 

maximum  control  of  the  program. 

■ ! 

Design  of  interactive  features  differs  from  the  design  ; 

' 

of  computational  features  in  that  the  former  must  be  built  into 

i 

the  most  basic  parts  of  the  program's  internal  structure  while 
the  latter  can  be  added  at  anytime.  Adding  an  interactive 
feature  will,  in  general,  require  modifications  to  the  entire 
structure  from  the  ground  up  while  adding  another  computational 
function  generally  has  little  effect  on  the  rest  of  the  .| 

program.  For  this  reason,  all  of  the  user  interface  goals 
outlined  above  will  be  included  as  goals  of  this  design  study 
from  the  very  beginning.  It  would  be  very  difficult  to  add 
one  at  a later  date. 

For  the  purpose  of  discussion,  an  interactive  user 

interface  can  be  divided  into  four  parts,  including i program  ' 

! 

control,  data-base  control,  error  protection,  and  user  ; 

assistance.  The  next  four  sections  discuss  these  parts  and  j 

what  features  they  should  include.  While  recommendations  will  | 

be  made  concerning  how  these  features  might  work,  discussion 
of  their  actual  implementation  will  be  saved  for  Chapter  IV. 

Program  Control  Interface  j 

I 

Complete  program  control  may  be  defined  as  the  ability  to  i 

randomly  select  program  functions  in  any  order  at  any  time 
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without  regard  for  what  functions  may  have  been  previously 
selected.  Such  control  is  highly  desirable  because  it  gives 
the  user  maximum  flexibility  to  use  the  available  functions 
to  their  fullest  potential.  It  also  protects  the  user  from 
getting  "locked  in"  to  pre-selected  sequences  from  which  there 
is  no  escape  short  of  complete  program  termination.  Complete 
program  control  places  all  of  the  program  functions  at  the 
user's  finger  tips  and  allows  the  user  to  define  what  operations 
are  to  be  performed. 

This  kind  of  control,  however,  is  not  without  its  hazards. 
If  the  user  is  completely  free  to  select  functions  in  any  order, 
he  is  also  completely  free  to  make  mistakes.  Great  care  must 
be  taken  when  designing  a control  interface  of  this  type,  to 
ensure  that  when  a user  does  make  an  error,  it  results  only  in 
an  error  message  and  not  in  a program  abort. 

This  section  discusses  ways  in  which  complete  program 
control  can  be  provided.  The  subject  of  error  protection 
will  be  covered  later  in  this  chapter. 

Two  widely  used  methods  for  providing  program  control  are 
to  have  the  user  type  a command  or  select  an  option  number. 
(Refs.  2,  3,  4,  5,  6,  7,  29)  Each  of  these  techniques  has 
its  own  desirable  features.  Commands  put  the  user  in  very 
direct  control  of  the  program  and  are  particularly  useful  for 
simple,  frequently  used  functions  with  few  parameters. 
Unfortunately,  when  a program  has  a lot  of  options,  commands 
require  a user  to  learn  a large  vocabulary  before  he  can  use 
the  program  effectively.  This  is  always  undersirable, 
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especially  from  a beginner's  standpoint. 
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For  the  purposes  of  this  program,  It  is  recommended  that 
the  best  features  of  both  methods  be  used.  \Vhen  a function  is 
simple  and  frequently  used,  it  is  easy  to  remember  and  may  be 
provided  as  a command  name.  More  complicated  and  less 
frequently  used  functions  are  more  difficult  to  remember  and 
may  be  best  presented  to  the  user  as  a list  of  option  numbers 
to  which  he  can  refer. 

One  final  item  which  should  be  discussed  under  this 
heading  is  the  "switch"  concept.  Certain  functions  which  allow 
the  user  to  select  his  own  favorite  modes  or  operation  (such 
as  whether  angles  are  calculated  in  radians  or  degrees,  or 
whether  the  program  should  repeat  (echo)  all  input  it  receives), 
may  best  be  provided  as  a series  of  switches.  Switches  are 
simply  logical  variables  which  can  be  set  either  "on"  or  "off" 
by  command  from  the  user.  Such  switches  may  be  used  in  any 
case  where  the  user  has  a choice  between  one  of  two  modes  of 
operation.  They  are  particularly  beneficial  in  that  the 
user  can  custom  tailor  the  program  to  suit  his  own  preferences. 
Very  simply,  a switch  should  be  used  for  the  type  of  command 
that  is  to  remain  in  effect  until  changed  by  the  user. 
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-base  Control  Interface 

Complete  control  of  the  program  functions  alone  is  not 
enough  to  provide  an  efficient  user  interface.  The  user  must 
also  be  provided  with  control  of  the  data-base  on  which  the 
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functions  operate.  This  Is  important  because  the  user  will  often 
want  to  use  data  already  stored  in  the  computer  with  only 
minor  changes  in  its  form  or  location.  Incomplete  data-base 
control  may  require  the  user  to  do  unnecessary  retyping 
which  is  contrary  to  the  goal  of  easy  operation. 

In  this  report,  complete  data-base  control  is  defined  as 
the  ability  to  list,  modify,  and  transfer  the  contents  of  any 
variable  used  by  the  program.  This  section  discusses  some  of 
the  possible  techniques  that  can  be  used  to  give  the  user 
this  kind  of  control. 

The  first  element  of  a data-base  control  interface 
which  must  be  developed  is  a reference  system  which  will  allow 
the  user  to  designate  which  storage  locations  are  to  be  operated 
upon.  V^hile  some  sort  of  reference  system  which  assigns  a 
number  to  each  location  in  the  data-base  is  a possibility,  the 
preferred  technique  is  to  give  every  variable  or  variable  array 
a name.  The  user  can  then  refer  to  each  storage  location  by 
typing  its  corresponding  variable  name.  This  system  will  work 
well  as  long  as  care  is  taken  to  see  that  each  variable  is 
given  a logical,  easy  to  remember  name.  A discussion  of 
variable  names  chosen  for  the  program  being  developed  as  a 
part  of  this  study  is  given  in  Chapter  IV. 

To  list  the  contents  of  any  variable  location,  it  is 
possible  to  have  a command  or  option  called  "list  variables" 
which,  when  selected,  would  ask  the  user  to  specify  which 
variable(s)  should  be  listed.  A far  more  simple  and  direct 
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approach,  however,  would  be  to  have  the  user  simply  type  the 
variable  name  as  a command  to  list  that  variable.  This 
technique  is  nearly  optimal  in  the  sense  that  it  requires  a 
minimum  amount  of  typing  by  the  user. 

Similarly,  there  could  be  a command  called  "modify 
variables"  which  would  ask  the  user  to  specify  which  variable 
to  change  and  its  new  value.  The  easiest  technique,  however, 
is  to  simply  type  the  variable’s  name  and  subscripts  (if  any) 
followed  by  an  equal  sign  followed  by  its  new  value,  all  on 
one  line  as  a command  to  make  the  indicated  modification. 

Transfer  of  information  from  one  variable  to  another  is 
a more  complicated  procedure.  For  simple  scalar  variables,  the 
easiest  technique  is  probably  the  same  as  for  modification  as 
described  above.  That  is,  the  user  can  type  the  name  of  the 
variable  to  receive  information  followed  by  an  equal  sign 
followed  by  the  name  of  the  variable  from  which  the  information 
is  to  be  obtained.  For  arrays  of  variables,  where  the  meaning 
of  an  equal  sign  would  be  less  clear,  a special  copy  command 
could  be  used.  One  form  of  such  a command  could  be* 

"COPY, VARA ,VARB"  which  would  instruct  the  program  to  copy 
the  contents  of  the  variable  named  VARA  into  the  one  named 
VARB.  Either  or  both  of  these  procedures  would  perform  the 
required  transfer  operation  with  minimum  user  effort. 


Error  Protection  and  Recovery  Interface 

One  of  the  most  frustrating  problems  that  plague 
interactive  programs  today  is  the  devastating  effect  of 
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inadvertant  input  errors.  For  the  purpose  of  this  discussion, 
these  errors  can  be  placed  into  three  general  classes: 

(1)  Typing  an  illegal  character. 

(2)  Typing  a number  outside  the  range  of  acceptable  values 
for  a particular  variable. 

(3)  Typing  a number  which  will  cause  an  arithmentic 
operation  to  become  uncomputable . 

All  three  error  types  can  result  in  immediate  termination  of 

the  program  and  complete  loss  of  data.  When  this  happens,  the 

user  is  left  with  no  recourse  but  to  begin  typing  this  input 

all  over  again. 

Since  most  of  the  time  spent  using  a program  is  devoted 
to  typing  in  data,  if  the  unnecessary  retyping  caused  by  those 
errors  could  be  avoided,  a tremendous  improvement  in  efficiency 
could  be  achieved.  This  section  discusses  several  ways  in  • 
which  the  effects  of  inevitable  user  errors  can  be  eliminated. 

As  long  as  standard  FORTRAN  RtlXD  routines  are  used  to 
r'?ceive  input  from  the  user,  there  is  little  that  can  be  done 
about  common  typographical  errors.  (Ref.  15 i 5-5).  Once  the 
READ  routine  has  been  called,  control  Is  out  of  the  programmer's 
hands  until  the  routine  has  successfully  obtained  the  requested 
input.  If  an  input  error  is  encountered,  the  READ  routine  will 
either  print  the  cryptic  message:  "ERROR,  RETYPE  RECORD  AT  THIS 
FIELD"  or  terminate  the  program  completely.  No  opportunity 
for  calling  a recovery  routine  is  ever  provided. 

The  only  good  solution  is  to  develop  an  alternate  read 
subprogram  to  replace  the  standard  FORTRAN  one.  Such  a 
subprogram  could  read  data  in  alphanumeric  format  (a  standard 
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FORTRAN  format  which  will  accept  any  character)  and  then 

convert  it  to  usable  form  using  a translation  routine.  Any 

illegal  characters  detected  when  converting  a lino  of  data  ^ 

would  be  called  to  the  user's  attention  by  an  understandable 

error  message  and  the  user  given  an  immediate  opportunity  to 

make  the  needed  correction.  This  approach  would  virtually  ; 

eliminate  the  greatest  single  cause  of  abnormal  program  * 

f 

termination*  the  typographical  error. 

i 

Errors  caused  by  the  user  typing  a number  outside  the  ■ 

range  of  acceptable  values  are  easy  to  avoid.  All  that  is 
necessary  is  to  test  each  number  when  it  is  received  to  ensure 
that  it  is  within  its  legal  limits.  If  it  is  not,  an  error 
message  can  be  printed  and  the  user  asked  to  retype  the  number. 

Finally,  errors  due  to  Illegal  arithmetic  operations  must 
be  eliminated.  This  is  somewhat  more  difficult  than  the  j 

preceding  kind  of  error  because  it  requires  the  programmer  1 

to  anticipate  every  possible  arithmetic  error.  The  only  sure  i I 

I ! 

method  is  to  test  the  argument  of  every  operation  that  can  | , 

4 ' 

produce  such  an  error  before  the  operation  is  executed.  This  { 

i 

can  make  programming  somewhat  more  difficult  but  the  resulting  j I 

• I 

* : 

product  is  far  more  reliable.  Table  I lists  some  of  the  j! 

J I 

common  functions  which  can  cause  abnormal  program  termination  j ^ 

if  they  are  given  an  illegal  argument.  I I 


User  Assistance  Interface 

To  make  an  interactive  program  equally  convenient  for 
both  the  beginner  and  the  experienced  user,  a special  kind  of 


TABLE  I 

Some  common  functions  that  have  possible  illegal  arguments. 


Function  Symbolic  Name  Error  Condition 


Division 

A/B 

B = 0 

Natural  Logrithm 

ALOG(A) 

A ^ 0 

Common  Logrithm 

ALOGIO(A) 

A 5 0 

Square  Root 

SQRT(X) 

X < 0 

Arcsine 

ASIN(A) 

|A|  > 1 

Arccosine 

ACOS(A) 

|A|>1 

Exponential 

EXP(A) 

|a1  > 675.84* 

* Number  is  a function  of  word  length  and  may  differ  from 
machine  to  machine. 
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user  assistance  interface  must  be  developed.  This  interface 
must  be  able  to  teach  a new  user  how  to  operate  the  program, 
provide  quick  memory  refreshing  and  prompting  for  the  familiar 
user,  and  yet  stay  completely  out  of  the  way  of  the  expert 
who  has  no  need  for  help. 

The  first  and  most  important  function  that  the  user 
assistance  interface  must  perform  is  to  provide  the  user  with 
a list  of  options  that  are  available  to  him.  The  user  should 
be  able  to  obtain  this  list  at  any  time  but  it  should  not  be 
printed  out  automatically.  Nothing  is  more  irritating  to  an 
experienced  user  than  to  have  to  wait  for  a program  to  nrint 
unwanted  information.  Since  a large  program  will,  in  general, 
have  more  options  than  a user  will  want  to  see  at  one  time, 
the  list  of  options  should  be  divided  into  groups  according 
to  function  so  that  the  user  can  get  a short  list  of  options 
for  the  group  in  which  he  is  interested. 

Finally,  provision  should  be  made  for  several  levels  of 
prompting  when  the  user  is  requested  to  input  data.  The 
experienced  user  may  want  his  prompts  to  be  short  and  to  the 
point  such  as  I "ENTER  \VMIN,WMAX  > The  new  user,  however, 
may  not  know  that  "\^MIN"  and  "WMAX"  are  and  will  need  a more 
detailed  request  for  information.  One  possible  solution  to 
this  need  would  be  to  have  the  program  routinely  give  only 
brief  prompts  and  if  the  user  does  not  understand  what  is 
needed  he  can  type  a question  mark  for  further  details. 
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The  thing  that  should  be  remembered  is  that  users  do 
not  always  have  a user’s  manual  handy  when  they  are  using  a 
program.  If  the  user  assistance  interface  is  properly 
designed,  such  a lack  should  not  be  a serious  handicap. 

Summary 

An  efficient  user  interface  has  been  defined  as  one 
which  gives  the  user  maximum  control  of  an  interactive 
program  with  minimum  input  effort.  The  purpose  of  this 
chapter  has  been  to  develop  the  requirements  for  such  an 
interface  with  the  goal  of  making  a program  truely  easy  to 
use. 


C 


23 


( 


IV,  Devolopiiiont  and  Ri'al  i^ati  on  oT  Intorna  1 Structure 


The  precoecUnn  chapters  have  derincd  the  needs  and 


sneclfied  the  p.oals  for  operation  of  the  prop.rarn  to  be 
developed.  This  chayiter  discusses  the  actctil  internal 


realization  of  the  program.  The  external  realization  will 


,r  be  discussed  with  the  results  of  this  study  in  Chapter  V. 

t r 

1;  The  propram  to  be  described  was  piven  the  name  TOTAL 


to  reflect  the  fact  that  it  is  intended  to  eventually  perform 


the  total  ranpe  of  computations  needed  in  the  field  of  puidance 


and  control.  The  ten  functional  areas  selected  in  Chapter  IT 
and  all  of  the  interactive  features  discussed  in  Chapter  III 


were  combined  into  a propram  with  a form  permittinp  continued 


prov.’th.  How  tliis  was  accomplished  is  the  subject  of  the 
i followinp  sections. 


Desirn  Anproach 


One  of  the  problems  with  software  design  in  the  past  has 


been  that,  in  the  interest  of  minimizing;,  program  size  and 
memory  requirements,  program  understandability  and  maintainability 


have  been  sacrificed.  Programmers  have  relied  on  intuition. 


experience,  and  "pet  tricks"  to  optimize  their  programs  without 
realizing  tliat  such  tricks  make  it  very  difficult  for  others 


to  understand  and  use  the  codiag*  As  a result,  the  life  of 


most  software  has  been  very  short  because  improving  computer 


it 
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systems  and  changing  needs  soon  render  any  one  version  of 
( coding  obsolete.  If  the  original  author  of  the  program  is 

no  longer  available,  and  if  no  one  else  can  understand  the 
coding  well  enough  to  bring  it  up-to-date,  the  program  dies 
a rapid  death.  Software  designers  frequently  find  themselves 
"re- inventing  the  wheel"  because  it  Is  easier  to  write  an 
entirely  new  program  than  to  understand  and  modify  an  old 
one.  This  is  an  obvious  waste  of  time  and  resources. 

Recently  there  has  been  an  increasing  awareness  of  the 
need  for  standardized  programming  techniques  which  are 
universally  understandable.  One  such  attempt  to  provide  this 
standardization  is  the  "Structured  Analysis  and  Design 
Technique"  (SADT)  developed  by  SofTech,  Inc.  (Ref. 31  «6). 

^ SADT  is  a highly  developed  methodology  involving  many 

functional  analysis  and  system  design  concepts.  Three  of  these 
concepts  which  were  particularly  useful  in  the  development  of 
TOTAL  were,  modularity,  top-down  design,  and  documentation. 

(Ref.  32,  2-1).  The  following  paragraphs  briefly  discuss 
these  concepts  and  how  they  were  applied  to  TOTAL. 

Modularity.  Structured  Analysis  uses  the  concept  of 
modularity  to  develop  complex  programs  in  a "divide  and 
conquer  approach."  By  successively  breaking  the  program  into 
more  and  more,  smaller  and  smaller,  well-defined  modules,  the 
analyst  finally  arrives  at  small  enough  pieces  so  that  the 
function  of  each  individual  module  can  be  easily  understood 
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and  Its  interface  to  other  modules  clearly  seen.  Thus,  the 
complex  program  that  could  not  be  understood  in  its  total 
view  can  be  well  understood  by  seeing  each  of  its  modules  and 
how  they  fit  together.  In  fact,  once  this  modular  breakdown 
is  created,  replacement  modules  can  be  designed  and  "plugged-in" 
to  improve  the  performance  of  the  total  program. 

TOTAL  was  designed  using  this  modular  approach  by  making 
extensive  use  of  subprograms  and  program  overlays  (to  be 
discussed  in  this  chapter).  The  most  basic  functions  (such 
as  poljmomial  multiplication,  and  elementary  matrix  row 
reduction)  were  developed  first.  These  routines  were  then 
used  as  building  blocks  for  higher-level  functions  (such  as 
transfer  function  multiplication  and  matrix  Inversion)  which 
in  turn  were  used  for  still  higher  level  functions  (such  as 
block  diagram  manipulation  and  state-space  analysis).  The 
modular  design  approach  was  put  to  such  extensive  use  in  the 
development  of  TOTAL  that  many  of  its  programs  and  subprograms 
consist  of  almost  nothing  but  calls  to  lower  level  subprograms. 

Top-down  design.  In  order  to  develop  the  modular 
decomposition  described  in  the  preceeding  paragraphs,  it  was 
necessary  to  work  "from  the  top  down."  The  top-down  design 
approach  consists  simply  of  viewing  the  program  from  the 
highest  level,  most  general  viewpoint,  and  then  breaking  down 
this  view  into  finer  and  finer  levels  of  detail.  Without 
this  approach,  modular  decomposition  would  be  difficult. 
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For  example,  in  the  development  of  TOTAL,  tt  was  not  known 
that  polynomial  multiplication  and  addition  modules  would  be 
needed  until  the  fundamental  goal  of  block  diagram  manipulation 
capability  was  broken  down  into  the  need  to  add  and  multiply 
transfer  functions  which  in  turn  required  the  routines  to 
handle  polynomials. 

TOTAL  was  designed  using  the  top-down  approach  as 
follows*  First,  the  program  was  divided  into  ten  functional 
areas  as  described  in  Chapter  II.  Each  of  these  areas  was 
then  further  divided  into  specific  functions  which  were  to 
become  the  individual  options  and  other  performance  features 
in  the  finished  program.  Next,  the  necessary  algorithms  and 
procedures  needed  to  perform  each  function  were  either  located 
or  developed.  Finally,  the  specific  blocks  of  coding  and 
subprograms  needed  to  implement  each  procedure  were  written. 
Throughout  this  top-down  design  process,  decisions  were  made 
with  program  simplicity,  size  limitations,  and  interactive 
requirements  in  mind. 

Documentation . The  third  fundamental  concept  used  in  the 
design  approach  for  TOTAL  was  the  need  for  continuous 
documentation.  This  concept  is  simply  that  documentation  is 
best  when  it  is  produced  continuously  throughout  the  project 
%diile  the  design  decisions  are  being  made  and  can  still  be 
seen  in  context.  (Ref.  31,  2-9)  By  recording  why  particular 
decisions  were  made  and  what  factors  influenced  them,  future 
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extension  and  modification  of  the  program  can  be  made 
easier. 

The  primary  reason  for  using  this  concept  during  the 
development  of  TOTAL,  however,  was  that  it  helped  to  avoid 
a documentation  phase  at  the  end  of  the  project.  Since  all 
steps  taken  in  developing  the  program  were  recorded  as  they 
occurred,  the  resulting  documentation  precisely  matched  the 
final  working  program.  Appendix  B,  the  Programmer’s  Manual 
for  TOTAL,  is  the  result  of  attempts  during  this  investigation 
to  achieve  this  desired  complete  documentati^on. 

Thus,  the  design  process  used  in  the.  development  of 
TOTAL  was  modular,  top-down,  and  documentation  oriented.  The 
remaining  sections  of  this  chapter  discuss  some  of  the  more 
Important  design  decisions Xhat  were  made. 


Overlays  vs.  Segmentation 

To  perform  all  of  the  functions  specified  as  goals  in  the 
preceeding  chapters  requires  a very  large  program.  In  fact, 
the  programs  and  subroutines  used  in  TOTAL  collectively 
require  more  than  600,000g  words  of  central  memory.  Since 
many  computer  systems  do  not  have  this  much  memory  available, 
(Ref.  1 il)  and  since  most  limit  interactive  users  to  a much 
smaller  amount  (on  the  order  of  60K)  (Ref.  1 :52),  it  was 
necessary  to  design  a program  structure  which  would  never 
require  more  than  60K  at  any  one  time.  Two  methods  for 
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fitting  a large  program  Into  a small  amount  of  memory  are 
available  Including  overlay  generation  and  segmentation. 

Overlay  generation  Is  simply  a way  of  dividing  a large 
program  Into  a series  of  smaller  programs  each  of  which  will 
fit  Into  the  available  amount  of  memory.  As  each  of  these 
programs  (overlays)  Is  needed.  It  Is  loaded  Into  memory 
replacing  one  which  has  just  finished  executing.  A small 
executive  routine,  written  to  control  the  overall  flow  of  the 
program.  Is  responsible  for  calling  each  overlay  Into  memory 
as  It  Is  needed.  This  executive  Is  called  the  main  overlay 
and  remains  In  central  memory  at  all  times.  The  small 
programs  which  It  controls  are  called  primary  overlays.  Only 
the  main  overlay  and  one  primary  overlay  are  ever  In  central 
memory  at  a given  time.  Thus,  the  maximum  amount  of  space 
needed  by  the  entire  program  Is  just  the  sum  of  the  sfjace  needed 
for  the  main  overlay  and  the  largest  primary  overlay. 

Overlay  generation  Is  a slmp,le  process.  It  requires  only 
the  addition  of  a few  new  statements  to  the  otherwise  normal 
FORTRAN  source  code  of  the  program. 

Segmentation  Is  a much  more  powerful  method  of  subdividing 
a large  prog.ram.  Unlike  overlays.  It  requires  the  addition 
of  no  new  statements  to  the  program.  Instead,  a separate 
set  of  control  statements  Is  written  describing  how  the  program 
Is  to  be  divided.  A special  routine  called  SEGLOAD  then  reads 
these  control  statements  and  divides  a compiled  version  of  the 
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proRrara,  as  directed,  automatically.  Once  a segmented  version 
of  the  program  has  been  generated,  it  is  used  like  any  other 
program. 
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Because  of  the  large  number  of  sophisticated  control 
directives  that  are  available  with  SEGLOAi),  segmentation  is 
a versatile  technique.  For  this  reason,  it  is  highly 
recommended  by  people  who  are  thoroughly  familiar  with  its 
use.  Unfortunately,  segmentation  is  very  complex  and  therefore 
more  difficult  to  learn.  (A  41 -page  manual  is  needed  to 
describe  the  process  --  Ref.  17). 

Thus,  there  is  a trade-off  between  overlay  generation 
and  segmentation.  Overlays  are  easier  to  use,  but  segmentation 
is  more  powerful.  Such  a choice  might  merit  careful 
consideration  if  overlays  were  not  capable  of  performing  all 
of  the  functions  needed.  However,  since  overlays  can  do 
everything  required  in  this  case,  the  fact  that  segmentation 
is  more  powerful  is  irrelevant.  In  keeping  with  the  goal  of 
making  the  program  easy  to  extend  or  modify  for  as  many 
people  as  possible,  the  overlay  technique  must  be  selected. 

The  more  powerful  features  of  segmentation  are  simply  not 
needed . 

Complete  information  on  overlays  and  segmentation  is 
given  in  Ref. 17. 
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Once  the  overlay  approach  had  been  selected,  it  was  only 


I 
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necessary  to  divide  the  program  into  approximately  equal 

pieces  small  enough  to  fit  in  60,000g  words  of  central 

memory.  TOTAL  was  divided  into  one  main  overlay,  seventeen 

primary  overlays  and  eleven  secondary  overlays.  A general 

flow  chart  showinp,  this  overlay  structure  is  given  in  Fig.  1. 

The  main  overlay  (Overlay  (0,0)  in  Fig.  1)  holds  the 

common  data  arrays,  establishes  their  default  values,  and 

calls  each  primary  overlay  as  it  is  needed.  Since  each 

program  function  may  be  performed,  in  general,  by  any  one  of 

these  seventeen  primary  overlays,  a short  decision  making  j 

« 

routine  is  used  to  determine  which  overlay  should  be  called.  t 

This  routine  is  simply  a massive  computed  GO  TO  statement  in  I 

the  main  overlay  called  the  "master  overlay  selector" : 


GO 

TOC  If  3f  3f  3f  3f 

3f 

3f 

3f 

3f 

9f 

+ 

. 14f 14f 14f 14f 14f 

14f 

14f 

14f 

9f 

9f 

+ 

17f 17f 17f 17f 14, 

14f 

14f 

17f 

17f 

9f 

+ 

2f  2f  2f  2f  2f 

2f 

2f 

2f 

2f 

9f 

+ 

4f  4f  4f  4f  4f 

4f 

4f 

4f 

4f 

9f 

+ 

5f  5f  5f  5f  5f 

5f 

9f 

9f 

9f 

9f 

+ 

3f  3f  3f  3f  3f 

3f 

3f 

3f 

3f 

9f 

+ 

14f 14f 14f 14f 14f 

14, 

14f 

14f 

14f 

9f 

+ 

16fl6fl6fl6fl6f 

16f 

9f 

9f 

16f 

9f 

+ If  9f  13f  9f  18f  9f  9f  9f  9f  9)f  NOPT 

Entries  in  this  GO  TO  statement  are  indexed  by  the  option 
number,  NOPT,  and  are  simply  the  statement  numbers  of  the 
seventeen  overlay  calling  statements  shown  in  Fig.  2.  If 
a user  selects,  for  example,  option  number  93,  control  is 
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CALL 

1 

CALL 


CALL 

3 

CALL 

4 


CALL 

5 

CALL 

6 

CALL 

7 

CALL 

8 


CALL 

9 

CALL 

10 

CALL 

11 

CALL 

13 

CALL 

14 

CALL 

15 


CALL 

16 

CALL 

17 


OVERLAY  UPDATE 
CALL  0VERLAY(5HT0TALf IfO) 
GO  TO  mil 
OVERLAY  PARTL 
CALL  OVERLAY (5HT0TALr2»0) 
GO  TO  11111 
OVERLAY  POLY 

CALL  OVERLAY (5HT0TAL»3»0) 
GO  TO  11111 
OVERLAY  ROOTL 
CALL  0VERLAY(5HT0TAL»4»0) 
IF<N0PT.Ea.48)  GO  TO  11 
GO  TO  mil 
OVERLAY  FREQR 
CALL  OVERLAY <5HT0TAL» 5 »0) 
GO  TO  mil 
OVERLAY  READER 
CALL  0VERLAY<5HT0TALf6»0) 
GO  TO  mil 
OVERLAY  DECODER- 
CALL  OVERLAY (5HT0TAL»7f0) 
GO  TO  mil 

CALCULATOR  (OVERLAY  READER) 
EXTCALC=.TRUE. 

CALL  OVERLAY <5HT0TAL»6»0) 
GO  TO  mil 
OVERLAY  HELP 

CALL  0VERLAY(5HT0TAL»9»0) 
GO  TO  mil 
OVERLAY  DMULR 
CALL  0VERLAY(5HT0TALf lOfO) 
GO  TO  mil 
OVERLAY  TTYPLOT 
CALL  0VERLAY(5HT0TALf llfO) 
GO  TO  mil 
OVERLAY  MISCELL 
CALL  OVERLAY (5HT0TAL»13»0) 
GO  TO  mil 
OVERLAY  MATRIX 
CALL  0VERLAY(5HT0TAL»14f0) 
GO  TO  mil 
OVERLAY  COPYIER 
CALL  0VERLAY<5HT0TAL»15»0) 
GO  TO  mil 
OVERLAY  XFORMS 
CALL  0VERLAY<5HT0TALf 16»0) 
GO  TO  mil 
OVERLAY  BLOCKER 
CALL  0VERLAY(5HT0TAL»17f0) 
GO  TO  mil 
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FIr.  2.  Primary  overlay  calling  statements. 
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transferred  to  the  statement  in  the  main  overlay  whose 
number  appears  in  the  93  entry  of  the  master  overlay 
selector.  In  this  case,  statement  number  13  would  be 
selected  which  is  just  the  calling  statement  for  Overlay(13,0) 
(see  Fig.  2).  Overlay  13  then  executes  option  93  and  returns 
control  to  the  main  overlay  which  repeats  the  entire  process 
for  the  next  user  command.  Complete  details  on  the  main 
overlay  are  given  in  Section  3 of  Appendix  B. 

Primary  overlays,  like  number  13,  perform  all  of  the 
actual  operations  in  TOTAL.  Each  is  responsible  for  a certain 
class  of  functions  which  may  include  option  and  command 
execution,  variable  definition  and  modification,  switch 
setting,  user  assistance,  and  interactive  user  interfacing. 

If  an  overlay  is  too  large  for  the  given  core  restriction,  it 
is  divided  into  secondary  overlays  that  will  fit.  Primary 
and  secondary  overlays  are  discussed  in  detail  in  Section  4 
of  Appendix  B. 


Data-base  Development 

An  important  aspect  in  the  internal  structure  development 
of  a program  is  the  design  of  an  effective  data  management 
system.  Variables  must  be  stored  in  a manner  that  will  permit 
ready  access  by  all  parts  of  the  program,  easy  modification 
and  Inspection  by  the  user,  and  efficient  use  of  computer 
memory.  There  are  four  possible  techniques  for  storing 
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information  in  a program.  Each  has  its  ovm  advantages  and 


< 


disadvantages  as  described  belowj 

(1)  Local  variables.  Local  variables  are  used  within 
a single  program  or  subroutine  for  storage  of 
information  while  that  particular  routine  is 
executing.  When  the  routine  has  finished,  the  space 
in  which  such  variables  are  stored  is  used  for 
something  else  and  the  variable  values  are  lost.  Local 
variables  are  useful  as  scratch  registers  which  are 
quickly  accessable  but  which  do  not  tie  up  any  memory 
locations  when  not  in  use. 

(2)  Global  variables.  Often  it  is  desired  to  keep  certain 
variables  in  memory  at  all  times  so  that  they  are 
available  to  any  routine  which  needs  them.  Such 
variables  are  called  global  or  common  variables. 

They  have  an  advantage  in  that  they  are  quickly 
accessable  and  are  not  lost  when  execution  passes  from 
one  routine  to  another.  They  have  a disadvantage  in 
that  they  take  up  memory  locations  at  all  times 
whether  they  are  in  use  or  not . 

(3)  Sequential -access  files.  In  the  event  that  large 
amounts  of  data  must  be  stored,  there  may  not  be 
sufficient  memory  locations  available  in  the  computer. 
One  possibility  is  to  write  all  information  to  a 
local  file  on  a disk  or  other  mass  storage  device. 

If  the  data  is  to  be  used  in  a single  block,  the 
simplest  technique  is  to  use  a sequential  format. 

This  means  that  data  is  written  and  read  from  the 
local  file  in  the  same  order.  This  technique  is 
slower  than  in-memory,  but  can  handle  much  more 
information.  It  has  an  advantage  over  random-access 
storage  in  that  it  can  be  coded  with  ordinary  FORTRAN 
WRITE  statements.  Its  chief  disadvantage  is  that 
information  must  be  read  from  the  file  in  the  same 
order  that  it  was  written. 

(4)  Random-access  files.  Another  form  of  mass  storage 
which  is  similar  to  the  sequential -access  file  is 
the  random-access  file.  The  chief  difference  and 
advantage  is  that  information  may  be  written  and  read 
on  a random-access  file  in  any  order.  The  chief 
disadvantage  is  the  more  complicated  input/output 
statements  which  are  required. 
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All  four  types  of  storage  are  used  In  TOTAL'S  data 
structure  to  combine  the  advantages  of  each.  VVhenever 
possible,  Information  needed  only  temporarily  during  the 
execution  of  a single  routine  is  stored  in  local  variables 
to  conserve  storage  space.  Infornacion  which  is  needed  in 
more  than  one  routine,  or  which  is  used  repeatedly  throughout 
the  program  is  stored  in  global  variables  defined  by  labeled 
COMMON  statements.  A sequential  access  file  is  used  to 
provide  a backup  memory  of  all  global  variables  so  that  the 
program  can  be  stopped  and  later  restarted  without  loss  of 
Information.  Finally,  a random-access  file  is  used  as  a mass 
storage  device  on  which  24  additional  transfer  function  arrays 
and  19  additional  matrix  arrays  can  be  stored. 

Selection  of  Variable  Names 

In  the  development  of  a data-base  control  interface  as 
described  in  Chapter  III,  it  was  decided  to  assign  a mnemonic 
reference  name  to  every  variable  or  variable  array  in  the 
data-base.  The  only  requirement  placed  on  these  names  was 
that  they  should  be  assigned  in  a logical,  easily  remembered 
manner.  This  section  discusses  what  names  were  chosen  and  how 
they  were  selected. 

The  data-base  variables  to  be  named  were  found  to  fall 
into  five  general  categories  Including:  transfer  functions. 
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since  these  are  natural  divisions  which  are  not  difficult 

to  remember,  It  was  decided  to  use  them  as  the  basis  for 

root  words  from  which  Individual  names  could  be  formed.  The 

following  list  shows  the  root  words  selected  as  reasonable 

mnemonic  names  for  each  of  the  five  groups « 

Group  Type  Mnemonic  Root  Word 

Transfer  functions  TF 

Polynomials  POLY 

Polynomial  roots  ROOT 

Matrices  MAT 

Scalar  constants  K 

Once  a root  word  had  been  determined  for  each  group,  all 
that  was  necessary  was  to  add  one  or  two  more  letters  to  it  to 
form  a unique  name  for  each  variable  In  the  group.  These 
additional  letters  should  naturally  be  selected  In  some 
logical  manne-^  as  described  below  for  each  group « 

Transfer  functions.  If  transfer  functions  were  to  be 
divided  Into  four  types  according  to  function,  one  possible 
partition  might  be»  1)  forward  transfer  functions,  2)  feedback 
transfer  functions,  3)  open-loop  transfer  functions,  and  4) 
closed-loop  transfer  functions.  This  partition  provides  a 
convenient  basis  for  naming  the  four  transfer  function  arrays 
stored  In  the  common  data  base.  Since  "G"  and  "H"  are  often 
used  In  the  literature  for  the  forward  and  feedback  transfer 
functions  respectively,  (Ref.  20,  21,2.'^and  since  "OL”  and  "CL" 
make  reasonable  abbreviations  for  "open-loop"  and  "closed-loop". 
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the  t'ollowinr,  n.ime  assi  p,nnients  v-ore  made  for  the  four  data- 
base transfer  functions! 


tr 


(1) 

GTF 

(2) 

IITF 

(3) 

OLTF 

(4) 

Cl  .TF 

Polynomial s . 

--  Forward  transfer  function 
--  Feedback  transfer  function 
--  Open-loop  transfer  function 
--  Closed-loop  transfer  function 

Polynornia'l  s . There  are  12  polynomial  arrays  to  be  named. 

Four  of  the  arrays  are  used  as  scratch  registers  for  polynomial 

arithmetic  and,  for  simplicity,  wore  assigned  the  letters  A, 

B,  C,  and  U to  distinpuish  between  them.  The  remaininp,  oipht 

arrays  are  paired  to  form  the  nuir.erator  and  denominator 

polynomials  of  the  four  transfer  functions.  Thus,  it  was 

logical  to  use  the  same  letters  (G,  H,  OL,  and  CL)  in  the 

names  of  caeh  j>air,  the  letters  "N"  for  "nvimerator"  and  "D"  for 


"denominator"  were 

listed  belowi 

used 

. The  rosultinp  polynomial 

names 

(1) 

F^LYA 

Coefficients  of  polynomial 

A 

(2) 

POLYB 

-- 

Coefficients  of  polynomial 

B 

(3) 

POLYC 

-- 

Coefficients  of  polynomial 

C 

(4). 

POLYU 

-- 

Coefficients  of  polynomial 

I) 

(5) 

GNPOLY 

-- 

GTF  numerator  polynomial 

(6) 

GDPOLY 

-- 

GTF  denominator  polynomial 

(7) 

UNPOLY 

-- 

HTF  numerator  polynomial 

(8) 

HDPOLY 

-- 

HTF  denominator  polynomial 

(9) 

OLNI^OLY 

-- 

OLTF  numerator  polynomial 

(10) 

OLDPOLY 

-- 

OLTF  denominator  polynomial 

(11) 

CI.NP0LY 

-- 

CLTF  numerator  polynomial 

(12) 

CLDPOLY 

CLTF  denominator  pclvnomial 

• i 

I I 
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Polynomial  roots.  Corresponding  to  the  12  polynomials 
named  earlier  are  12  arrays  of  polynomial  roots.  These 
arrays  can  be  distinguished  in  a natural  way  using  the  same 
symbols  used  in  the  polynomial  names  and  the  root  word  "ROOT". 
Thus,  ROOTA  was  used  for  the  roots  of  POLYA,  ROOTS  for  POLYS, 
and  so  on.  However,  because  transfer  function  numerator  and 
denominator  roots  are  often  called  "zeros"  and  "poles" 
respectively,  it  was  decided  to  modify  the  root  word  in  these 
cases  and  substitute  "ZERO"  for  "NROOT"  and  "POLE“for  "DROOT" . 
This  scheme  resulted  in  the  following  name  assignments  for  the 


12  root  arrays  1 

(1)  ROOTA 

Roofs  of  POLYA 

(2) 

ROOTB 

-- 

Roots  of  POLYB 

(3) 

ROOTC 

-- 

Roots  of  POLYC 

( (4) 

ROOTD 

-- 

Roots  of  POLYD 

! (5) 

GZERO 

-- 

GTF  ZEROS  (roots  of  GNPOLY) 

(6) 

GPOLE 

-- 

GTF  POLES  (roots  of  GDPOLY) 

(7) 

HZERO 

-- 

HTF  ZEROS  (roots  of  HNPOLY) 

(8) 

HPOLE 

-- 

HTF  POLES  (roots  of  HDPOLY) 

i (9) 

OLZERO 

-- 

OLTF  ZEROS  (roots  of  OLNPOLY) 

j (10) 

OLPOLE 

-- 

OLTF  POLES  (roots  of  OLDPOLY) 

(11) 

CLZERO 

-- 

CLTF  ZEROS  (roots  of  CLNPOLY) 

(12) 

CLPOLE 

-- 

CLTF  POLES  (roots  of  CLDPOLY) 

Matrices. 

Since 

the  letters  A,  B,  C,  D,  F,  G, 

are  common  matrix  names  used  in  digital  and  continuous  control 
work,  it  was  decided  to  use  them  for  the  seven  matrix  arrays 
in  the  data  base.  Along  with  the  root  word  "MAT",  these 
letters  formed  the  names  on  the  next  page. 
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AMAT 

BHAT 

CMAT 


J 

f 


Continuous  system  matrix 
Continuous  input  matrix 
Output  matrix 


DMAT  --  Direct  transmission  matrix 
FMAT  --  Discrete  system  matrix 
GMAT  --  Discrete  input  matrix 
KMAT  --  State  variable  feedback  matrix 
Scalar  constants.  Twelve  of  the  more  than  60  scalar 
variables  found  in  the  data  base  are  polynomial  constants 
(highest  order  polynomial  coefficients).  These  variables  were 
designated  with  the  root  word  "K"  and  the  same  distinguishing 
letters  used  for  the  polynomial  arrays.  The  resulting  variable 
names  are  listed  belowt 


(1) 

PAK 

-- 

Polynomial  A constant 

(2) 

PBK 

-- 

Polynomial  B constant 

(3) 

PCK 

-- 

Polynomial  C constant 

(4) 

PDK 

-- 

Polynomial  D constant 

(5) 

GNK 

-- 

GTF  numerator  constant 

(6) 

GDK 

-- 

GTF  denominator  constant 

(7) 

HNK 

-- 

HTF  numerator  constant 

(8) 

HDK 

-- 

HTF  denominator  constant 

(9) 

OLNK 

-- 

OLTF  numerator  constant 

(10) 

OLDK 

-- 

OLTF  denominator  constant 

(11) 

CLNK 

-- 

CLTF  aumerator  Constant 

(12) 

CLDK 

-- 

CLTF  denominator  constant 

The  remaining  scalar  variables  were  too  numerous  arid 
different  to  be  named  in  any  standard  manner.  These  variables 
were  simply  given  names  to  reflect  their  individual  functions. 


( 


throughout  the  program  and  can  be  defined  as  needed  In 
appropriate  sections  of  the  user's  manual  (See  Appendcx  A). 


( 


Realization  of  the  Interactive  User  Interface  I 

f 

In  Chanter  III  it  was  stated  that  an  interactive  user  ' 

interface  was  needed  to  perform  a variety  of  functions, 
including  program  control,  data-base  control,  error  protection  i 

and  recovery,  and  user  assistance.  This  section  describes,  in 
general  terms,  how  each  of  these  functions  were  realized.  ' 

Program  control  interface.  This  interface  provides  i 

control  to  the  user  in  two  ways « option  numbers  and  commands.  | 

Option  numbers  are  used  to  allow  the  user  to  select  any  of  the  j 

actual  computation  functions  in  the  program.  They  were  I 

implemented  by  an  input  routine  which,  when  it  encounters  a 
valid  oDtion  number,  executes  a computed  GO  TO  statement  with 
a branch  for  each  option.  Commands  were  used  to  perform 
simole  functions  on  the  program  itself  such  as  the  setting  of 
a mode  control  switch  or  the  transfer  of  information  from  one  t 

part  of  the  program  to  another.  They  were  implemented  using  j, 

i 

another  input  routine  which,  when  it  encounters  an  alphanumeric  \ 

i 

name,  consults  a table  of  valid  names  and  executes  the  command 
corresponding  to  the  matching  element.  A complete  development 
of  the  program  control  structure  is  given  in  Section  3 of  the 
programmer's  manual  (see  Appendix  B). 


41 


I 


I 

Data-base  control  Interface.  The  data-base  control  ' 

^ Interface  allows  the  user  to  (1)  display  the  contents  of 

a variable  by  typing  Its  variable  name,  (2)  modify  the 
contents  of  a variable  by  setting  Its  name  equal  to  the 

1 

desired  new  value,  and  (3)  transfer  the  contents  of  one 

I 

variable  to  another  by  equating  variable  names. 

This  Interface  was  Implemented  as  a translator  routine  | 

which  converts  a string  of  user  Inputs  such  as  variable 
names,  equal  signs,  and  numerical  values  Into  an  array  of 
coded  numbers.  Control  Is  then  provided  by  another  routine 
which  follows  the  array  of  coded  commands  and  performs  all 
of  the  necessary  manipulations  of  variables  In  the  data- 
base. The  actual  operation  of  this  Interface  Is  discussed  | 

^ under  programs  READER  and  DECODER  In  Section  4 of  the 

programmer's  manual  (see  Appendix  B) . 

Error  protection  and  recovery  Interface.  Error  protection 
and  recovery  Is  provided  automatically  by  all  Input  routines 
used  In  the  program.  All  Input  from  the  user  Is  read  first 
in  alphanumeric  format  and  then  translated  Into  useable 
form  while  being  checked  for  errors.  If  an  error  Is  found, 
the  user  Is  notified,  all  correct  Information  Is  printed  up 
to  where  the  error  occurred,  and  the  user  allowed  to  continue 
typing  from  that  point.  Complete  details  on  this  Interface 
are  given  under  subroutine  REt\DS  In  Section  5 of  the 
programmer's  manual  (see  Appendix  B). 

C 
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User  assistance  interface.  An  entire  program  in 
TOTAL'S  overlay  structure  is  devoted  exclusively  to  printing 
user  assistance  messages.  \^enever  a need  for  help  is 


noted  by  any  of  the  other  Interfaces,  control  is  transferred  ^ 

to  this  program  and  an  aporopriate  message  is  printed.  ' ' 

Further  details  on  this  interface  are  given  in  Section  4 
of  the  programmer's  manual. 

! 

Summary 

This  chapter  has  been  written  to  provide  an  overview 
of  how  the  internal  structure  of  TOTAL  was  developed.  It 
is  intended  to  bridge  the  gap  between  the  development  of 
program  specifications  in  Chapters  II  and  III  and  the  | 

detailed  accounts  of  the  actual  internal  and  external 
realizations  presented  in  the  appendicies. 


V . Results  and  Recommendations 


The  goal  of  this  investigation  was  to  develop  a 
computationally  powerful,  fully  interactive  computer  program 
capable  of  growing  into  a comprehensive  computer-aided  design 
tool  for  the  entire  field  of  guidance  and  control.  This 
chapter  describes  what  was  actually  accomplished  and  where 
further  work  can  be  done. 

Summary  of  Results 

There  were  four  major  accomplishments  produced  as  a 
result  of  this  study.  These  accomplishments  include  a working 
computer  program,  a detailed  user's  manual,  a fully  documented 
programmer's  manual,  and  this  report.  The  following 
paragraphs  discuss  the  nature  and  extent  of  each  of  these 
accomplishments . 

The  cpmouter  proRram.  The  most  visible  result  of  this 
study  is  the  program  TOTAL  which  is  now  in  use  by  faculty  and 
students  at  the  Air  Force  Institute  of  Technology  School  of 
Engineering.  TOTAL  can  best  be  described  as  "an  interactive 
computer-aided  design  program  for  digital  and  continuous 
control  system  analysis  and  synthesis."  This  section  describes. 
In  general  terms,  the  many  functions  which  TOTAL  can  currently 
perform. 

TOTAL  Is  designed  as  a tool  to  be  used  with  as  much 
speed,  agility,  and  confidence  as  one  would  use  a familiar 
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hand  calculator.  Its  interactive  Interface  allows  the 

user  complete  freedom  to  select  options,  modify  variables,  and 

give  commands  without  fear  of  abnormal  program  termination 

due  to  input  errors  of  any  kind.  Its  computational  features 

provide  an  extensive  array  of  powerful  tools  which  may  be 

used  directly  or  combined  to  form  even  more  powerful  functions. 

The  basic  “building  block”  tools  provided  by  TOTAL  in  its 

current  state  of  development  include: 

Discrete  and  continuous  root  locus  analysis  Including 
tabular  listings,  printer  plots,  and  Calcomp  plots.  | 

Discrete  and  continuous  time  response  analysis 
including  tabular  listings,  printer  plots,  i 

figures  of  merit  computation,  and  Calcomp  plots.  , 

Discrete  and  continuous  frequency  response  analysis 
including  tabular  listings,  printer  plots,  and 
Calcomp  plots. 

Block  diagram  manipulations  Including  addition  and 
multiplication  of  transfer  functions  and  closing  of 
feedback  loops. 

Discrete  and  continuous  state-space  to  transfer 
function  conversions. 

Continuous  to  discrete  transfer  function  digitization 
using  impulse  invariance,  bilinear,  and  first - 
difference  transformations. 

i 

Polynomial  operations  including  addition,  subtraction,  , 

multiplication,  division,  expansion,  and  factoring. 

Matrix  operations  including  addition,  subtraction, 
multiplication,  inversion,  transposition,  matrix  i 

exponentiation,  determinant  computation,  and  Hermite  ♦ 

normal  form  reduction.  ! 

Calculation  of  state-transition  and  resolvant  | 

matrices.  1 

Scalar  operations  performed  by  a built-in  20-memory 
scientific  calculator. 

Inverse  Laplace  and  z-transforras . 

Partial  fraction  expansion  of  transfer  functions. 
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The  program  also  allows  the  user  to  define  additional 
macro  routines  from  the  building  blocks  listed  previously. 


Provision  Is  made  for  these  routines  and  all  other  Information 
stored  In  the  program  to  be  saved  In  external  storage  files 
for  use  In  subsequent  runs  of  the  program.  Help  Is  available 
at  all  times  providing  several  levels  of  user  assistance. 

The  features  previously  described  form  a very  powerful 
subset  of  all  the  functions  that  are  needed  In  the  field. 

TOTAL  has  been  designed  with  a structure  that  will  allow  easy 
addition  of  new  capabilities  as  they  are  developed. 

The  user's  manual.  Development  of  a detailed  user's 
manual  was  as  Important  as  the  development  of  the  program 
Itself.  Without  such  a manual,  use  of  the  program  would  have 
to  rely  on  word  of  mouth  Instruction  and  many  of  the  most 
sophisticated  routines  would  remain  forever  unused.  For  this 
reason,  great  care  was  taken  to  ensure  that  every  worthwhile 
bit  of  Information  concerning  the  program  was  Included  In  a 
clear  and  logical  manner.  Liberal  use  of  examples  was  made 
throughout  the  manual  to  further  this  end.  The  user's  manual 
was  produced  as  a separate  document  entitled  User's  Manual  for 
TOTAL.  It  Is  Included  In  this  report  as  Appendix  A. 

The  programmer's  manual.  The  programmer's  manual  was 
written  to  provide  documentation  on  all  programs  and  subprograms 
used  In  TOTAL  as  well  as  a description  of  the  overall  structure 
and  Internal  operation  of  the  program.  It  Is  Intended  for  the 
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individual  who  wishes  to  make  his  own  modifications  and 
additions  to  the  program  and  as  a general  aid  in  maintaining 
the  program  or  transporting  it  from  one  computer  system  to 
another. 

i^hile  the  ProRrammer's  Manual  for  TOTAL  has  been  written 
as  a separate  document  specializing  on  the  internal  structure 
of  TOTAL,  it  is  best  used  in  conjunction  with  the  user’s  manual 
and  the  rest  of  this  report.  This  is  because  effective 
programming  requires  a knowledge  of  what  a program  is  supposed 
to  do  and  why  it  is  supposed  to  do  it  in  addition  to  how  it  is 
supposed  to  work.  The  programmer’s  manual  is  included  in  this 
report  as  Appendix  B. 

This  report.  This  report  has  been  written  with  the 
intent  of  explaining  what  was  needed  in  computer-aided  design 
for  guidance  and  control,  why  it  was  needed,  and  the  approaches 
taken  to  obtain  it.  Because  separate  documents  (Appendices 
A and  B)  were  written  to  explain  the  actual  internal  and 
external  operation  of  the  program,  it  was  possible  to  omit  this 
information  from  the  body  of  the  report.  Such  an  approach 
streamlined  the  report  considerably  and  allowed  discussion 
of  philosophical  and  developmental  considerations  without 
getting  lost  in  eccessive  detail.  Together  with  the  appendices, 
thl s report  provides  a thorough  description  of  the  program 
from  its  conception  through  its  current  state  of  development 
to  its  final  realization. 
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There  are  two  directions  In  which  further  development 


computer-aided  design  software  can  be  pursued!  (1)  the  ’ 

addition  of  Interactive  graphics  capability  and  (2)  the 
development  of  new  program  functions.  j 

Interactive  graphics  Is  a technique  in  which  the  user  | 

controls  the  program  with  a light  pen  and  In  which  output 
Is  displayed  Instantly  in  a variety  of  graphical  forms.  ' | 

The  addition  of  Interactive  graphics  features  to  TOTAL 
would  be  a project  which,  if  successfully  completed,  would 
provide  a quantum  leap  in  available  computer-aided  design 
capability.  Such  a project  would  not  require  excessive 
rewriting  of  existing  programs  because  TOTAL  has  already  been 
developed  with  an  interactive  structure.  The  commands  and  option 
numbers  which  control  TOTAL  are  ideally  suited  for  display  in  i 

I 

a graphics  menu  format. 

I 

An  area  of  greater  interest  to  the  guidance  and  control  i 

I 

student  is  the  development  of  additional  program  functions.  j ^ 

* j 

All  of  the  ground  work  and  structure  design  for  the  program  | 

i 

has  been  accomplished  during  this  investigation  so  that  future  1 

efforts  need  only  be  concerned  with  the  theoretical  and 

i 

computational  aspects  of  the  new  functions  themselves.  There 
is  virtually  unlimited  room  for  continued  development  of  j 

computer-aided  design  tools  in  the  field  of  guidance  and  i 

control.  The  reader  is  referred  to  Chapter  II  for  a list  of 
some  of  the  potential  areas  where  further  work  is  needed. 
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OVERVIEW  OF  TOTAL 


TOTAL  is  designed  as  a tool  to  be  used  with  as  much  speedi 

agility,  and  confidence  as  one  would  use  a familiar  hand 

calculator.  To  help  the  casual  user  get  a quick  idea  of  what 

TOTAL  is  about,  the  following  overview  is  provided. 

* TOTAL  is  built  around  twelve  general-purpose  polynomials 
of  maximum  degree  50,  and  seven  general-purpose  10  x 10 
matrices. 

* Eight  of  the  polynomials  may  be  paired  to  form  the 
numerators  and  denominators  of  four  general-purpose 
transfer  functions. 

* With  just  these  polynomials,  matrices,  and  transfer  functions, 
the  user  is  able  to  use  the  entire  spectrum  of  TOTAL'S 
capabilities,  which  include i 

• Add,  subtract,  multiply,  divide,  factor,  expand,  and 
copy  polynomials. 

• Add,  subtract,  multiply,  invert,  transpose,  obtain 
eigenvalues,  preset,  and  copy  matrices. 

• Obtain  root  locus,  frequency  response,  and  time 
response  in  both  continuous  and  digital  domain  of 
open  and  closed-loop  transfer  functions. 

• Perform  block  diagram  reduction. 

• Compute  transfer  functions  from  state-space. 

• Transform  between  continuous  and  digital  domains  using 
a variety  of  methods. 

* A built-in  20-memory  scientific  calculator  with  a 4-register 
stack  is  available  to  the  user  at  all  times. 

* The  user  may  quickly  list,  transfer,  or  modify  any  variable, 
at  any  time,  anywhere  in  the  program. 

* Complete  error  detection,  diagnostics,  and  abnormal 
termination  protection  are  provided.  Specific  help  is 
available  at  any  time  by  simply  typing  a question  mark. 


JL  - 


SECTION  1 . INTRODUCTION  TO  TOTAL 


( 


{ 
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The  preceeding  overview  gave  a capsule  summary  of  what 
TOTAL  can  do.  This  section  summarizes  how  It  works. 

t 

TOTAL  Is  an  Interactive  program.  The  user  has  at  his 
disposal  100  options  and  a few  special  commands  with  which 
he  can  manipulate  a data  base  of  12  polynomials,  7 matrices, 
and  roughly  60  scalar  variables.  Each  option  uses  Inforraat’^n 
stored  In  these  variables  to  perform  a particular  function 
and  saves  the  results  for  output  or  future  use.  During 
execution  of  TOTAL,  the  user  has  complete  freedom  to  select 
options,  modify  variables,  and  give  commands  at  will.  The  | 

following  paragraphs  summarize  what  a person  needs  to  know 

I 

to  utilize  the  full  power  of  this  program. 

1.1  TOTAL’S  INPUT  MODES 

TOTAL  has  three  modes  In  which  It  pauses  for  the  user  to 
Input  Information!  OPTION,  DATA,  and  CALCULATOR.  Each  mode 

i 

has  its  own  vocabulary  of  allowable  Inputs  and  Its  own 
characteristic  prompt  to  the  user. 

OPTION  mode. 

OPTION  mode  Is  the  primary  command  mode  of  TOTAL  and  Is 
characterized  by  the  prompt! 

OPTION  > 

When  TOTAL  pauses  In  this  mode,  the  user  Is  free  to  type 
any  command,  select  any  option,  modify  any  variable,  or  list 
any  data.  It  Is  from  this  mode  that  the  user  controls  the 
program. 

A-2 
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As  many  commands,  options,  etc.  may  be  typed  on  one  line 
as  desired.  In  fact.  If  the  last  Item  on  a line  Is  followed 
by  a comma,  TOTAL  will  wait  for  another  line  of  Input  before 


I 

I 


beginning  execution.  Input  Items  must  be  separated  bv  commas 
or  blanks. 

DATA  mode. 

When  an  option  has  been  selected  and  data  Is  needed, 
TOTAL  will  ask  for  It.  This  Is  called  DATA  mode  and  Is 
characterized  by  a prompt  of  the  forms 


t 


ENTER  ITEMl,  ITEM2,  ITEM3  > 

In  this  mode,  the  user  has  a number  of  possible  responses i 

1 . He  can  type  In  the  desired  values  of  the  variables 
requested,  separated  by  commas  or  blanks.  In  which 
case  TOTAL  will  accept  the  data  and  continue  what  It 
was  doing. 

2.  If  he  does  not  understand  what  "ITEMl,  ITEM2,  and 
ITEM3"  are,  he  can  type  "?"  and  TOTAL  will  explain 
%diat  Information  Is  needed. 

3.  If  one  of  the  numbers  requested  needs  to  be  calculated, 
he  can  type  "C"  to  enter  CALCULATOR  mode.  When  he 
returns  from  CALCULATOR  mode,  the  prompt  (and  any 
numbers  which  he  may  have  already  typed)  are  repeated 
and  TOTAL  waits  where  he  left  off  for  the  remaining 
input. 

4*  If  bne  of  the  Items  is  to  have  the  same  value  as  the 
last  time  It  was  requested  (or  a default  value)  the 
user  does  not  need  to  Input  a number.  He  simply 
types  a in  the  place  of  the  Item  to  be  left 
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unchanged  and  continues  with  the  rest  of  the  input. 

5.  If  the  user  wants  to  know  what  the  current  values  of 
the  requested  variables  are,  he  can  type  "L"  for  a 
list.  Numbers  are  listed  in  the  order  they  were 
requested,  the  prompt  (and  any  numbers  typed  before 
"L")  are  repeated,  and  TOTAL  waits  where  the  user 
left  off  for  the  remaining  input. 

6.  If  one  of  the  numbers  requested  Is  currently  stored 
In  one  of  the  calculator  registers,  the  user  may  type 
X,  Y,  Z,  T or  Rl  through  R20  In  place  of  the 
corresponding  number.  This  Is  particularly  useful 
when  returning  from  CALCULATOR  mode  using  the  "C" 

opt Ion . 

In  fact,  the  user  can  access  any  variable  In  TOTAL 
this  way  by  typing  "C"  to  go  to  the  calculator,  the 
variable ?'s  name  to  enter  Its  value  into  the  X register, 
"C"  to  return  from  calculator,  and  "X"  to  tell  TOTAL 
to  use  the  value  now  stored  In  the  X register. 

7.  If,  for  any  reason,  the  user  wishes  to  abort  and 
return  to  OPTION  mode  Instead  of  continuing  he  niay  do 
so  by  typing  "$". 

The  user  may  mix  any  of  the  above  responses  as  needed 
while  In  DATA  mode.  TOTAL  remains  In  this  mode  until  all 
requested  data  has  been  supplied. 

CALCULATOR  mode. 

CALCULATOR  mode  may  be  entered  at  any  time  by  typing  "C" . 
The  calculator  operates  like  an  HP-45  calculator  (using  reverse 


I 

« 

> 
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polish  notation)  and  Is  designated  with  the  prompt i ** 
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When  this  prompt  Is  displayed,  the  user  may  type  a 
number,  a key  name  (type  KEYS  for  a list),  or  a for  a 
brief  explanation  of  the  calculator.  CALCULATOR  mode  Is 
terminated  by  typing  another  "C"  whereupon  TOTAL  returns  to 
the  mode  from  which  It  came.  Complete  details  on  TOTAL’S 
calculator  are  given  in  Section  5 of  this  manual. 


1.2  TOTAL’S  OPTIONS 

TOTAL  presently  contains  100  options  which  have  been 
divided  Into  groups  of  10  according  to  general  function.  The 


following  is  a list  of  the  ten  main  groups. 


0 - 9 
10  - 19 
20  - 29 
30  - 39 
40  - 49 
50  - 59 
60  - 69 
70  - 79 
80  - 89 
90  - 99 


Transfer  function  Input  options 
Matrix  Input  options 

Block  diagram  manipulation  and  state- space  options 
Digital  and  continuous  time  response  options 
Root  locus  options 

Digital  and  continuous  frequency  response  options 
Polynomial  operations 
Matrix  operations 

Digital  and  continuous  transformation  options 
Miscellaneous  options 


The  first  option  In  each  group  simply  lists  the  next  ten 


options.  For  example,  option  30  lists  options  30  - 39. 

Complete  details  on  these  options  are  given  In  Section  2 of 
this  manual.  A tabulated  list  of  all  options  Is  located  Inside 


the  back  cover. 


1.3  TOTAL’S  VARIABLES 

Every  variable  In  TOTAL’S  data  base  may  be  directly  listed 
or  modified  by  the  user  from  OPTION  mode.  Typing  a variable's 
name  will  list  the  current  value  of  chat  variable.  Typing  a 


( 


name,  followed  by  an  equal  sign,  followed  by  a number  or 
another  variable  name  will  assign  the  value  to  the  right  of 
the  equal  sign  to  the  variable  on  the  left.  Polynomial 
coefficients  are  referred  to  with  subscripts,  for  example 
POLY(l)  refers  to  the  highest  order  coefficient  in  POLYA. 

Matrix  elements  are  referred  to  with  two  subscripts. 

A complete  list  of  all  variables  Is  available  at  any 
time  using  option  97.  Details  on  how  to  modify  and  use  variables 
are  given  In  Section  4. 

1 .4  HELP 

Help  Is  available  to  the  user  at  all  times  and  may  be 
requested  In  two  ways.  In  option  mode,  typing  the  command 
"HELP,  option  number"  will  give  the  user  a short  explanation 
of  the  option  number  specified.  In  all  modes,  the  user  may 
type  "?"  for  assistance. 


i 
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SECTION  2.  COMPLETE  DESCRIPTION  OF  OPTIONS 


( 

TOTAL  presently  contains  100  options  arranged  In  groups  ^ 

of  ten  according  to  function.  To  execute  an  optlont  the  user 
h simply  types  the  option  number.  TOTAL  will  then  ask  for  ' 

I needed  Information  (If  any)  and  execute  the  option. 

.r 

The  following  Is  a detailed  description  of  each  option. 

It  Is  Intended  primarily  as  a reference  for  the  user  who 

wants  to  know  all  the  details  about  a particular  option.  The 

more  casual  user  may  wish  to  use  the  tabular  option  listing 

at  the  back  of  this  manual  for  quick  reference.  < 

i 

2.1  TRANSFER  FUNCTION  INPUT  OPTIONS 

~ 

Many  of  TOTAL’S  options  center  around  the  use  or  ' i 

( ! 

manipulation  of  transfer  functions.  Time  response,  frequency 

response,  and  root  locus  options,  for  example,  all  require  the  1 

Input  of  a transfer  function  prior  to  beglnrilng  calculations.  ' 

I ' 

Other  options  close  feedback  loops,  add  or  multiply  transfer  j i 

; I 

functions,  and  perform  related  operations.  TOTAL  provides  j 

four  working  registers  for  this  purposes  I 

GTF  Foirward  Transfer  Function 

HTF  Feedback  Transfer  Function  I 

OLTF  Open-loop  Transfer  Function  ! 

CLTF  Closed-loop  Transfer  Function  | 

All  transfer  function  operations  are  performed  with  respect  to  i 

I 

one  or  more  of  these  registers. 

C 
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Each  transfer  function  Is  made  up  of  a numerator 
polynomial  and  a denominator  polynomial  which  are  stored 
In  TOTAL  as  two  arrays  of  polynomial  coefficients.  The 
transfer  functions  listed  previously  may  be  defined  in  terms 
of  these  polynomial  arrays  asi 


n-rr-  GNPOLY 
* GDPOLY 


OLTF 


OLNPOLY 
* OLDPOLV 


HTF 


HNPOLY 

HDPOLY 


CLTF 


CLNPOLY 
■ CLDPOLY 


Each  of  these  polynomial  array  names  has  a specific  meaning. 
For  example,  OLDPOLY  stands  for  OLTF  Denominator  POLYnomial . 

Since  each  polynomial  can  be  factored  Into  a constant 
times  an  array  of  roots,  the  four  transfer  functions  may  also 
be  defined  asi 


GNK  • GZERO 
“ GDK  • GPOLE 


niTF  OLNK  • OLZERO 
* OLDK  • OLPOLE 


HTf  HNK  « HZERO 
“ HDK  • HPOLE 


ri  TF  CLNK  « CLZERO 
~ CLDK  • CLPOLE 


where  GZERO,  GPOLE,  HZERO,  HPOLE,  OLZERO,  OLPOLE,  CLZERO, 


and  CLPOLE  are  complex  arrays  of  polynomial  roots  and  GNK, 
GDK,  HNK,  HDK,  OLNK,  OLDK,  CLNK,  and  CLDK  are  corresponding 
constants.  These  variables  are  discussed  in  greater  detail 
In  Section  4. 

Options  2 through  9 allow  the  user  to  input  these 
transfer  functions  In  either  of  the  forms  described  above. 


OPTION  Qi  List  options. 

This  option  gives  a quick  reference  list  of  options  0 


I 

I 

I 


» 


t 


I 

I 

« 

4 


I 


C 


through  9.  The  user  may  use  this,  like  all  options  ending 
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In  zero,  to  refresh  his  memory  about  the  next  ten  options 
when  this  manual  Is  not  handy, 

OPTION  1 1 Recover  all  data  from  file  MEMORY. 

While  this  Is  not  a transfer  function  Input  option,  It 
Is  an  Input  option  and  Is  placed  here  because  of  Its  Importance. 

Option  1 reads  all  the  values  for  every  variable  In  TOTAL 
from  a local  file  "MEMORY."  During  execution  of  TOTAL,  the 
user  may  store  the  current  values  of  all  variables  Into  memory 
by  using  option  91.  (See  Section  2.10)  Data  Is  automatically 
stored  In  MEMORY  when  the  user  types  STOP. 

Thus  It  Is  possible  to  end  TOTAL,  do  something  else,  and 
restart  the  program  later  using  option  1 to  recover  the  data 
stored  In  MEMORY. 

OPTIONS  2.  3.  4.  and  5t  Polynomial  form  Input. 

These  options  are  Identical  In  format  and  allow  the  user 
to  Input  GTF,  HTF,  OLTF,  and  CLTF  transfer  functions, 

respectively.  In  polynomial  form.  | 

For  example.  If  the  user  has  an  open-loop  transfer  function 
(OLTF)  available  as  a ratio  of  two  polynomials,  he  may  Input  | 

it  using  option  4,  as  shown  on  the  following  page.  ! 

Note  that  the  Input  polynomials  (OLNPOLY  and  OLDPOLY) 
were  Immediately  factored  and  their  roots  stored  In  i 

corresponding  arrays  (OLZERO  and  OLPOLE) . The  listing  shown  I 

In  boxes  Is  suppressed  If  ECHO  mode  Is  off  (see  option  93,  ^ 

Section  2.10)  I 

I 
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□PTION  > 4 


POLYNOMIAL  INPUT  OF  OLTF<S> 

ENTER  NUN  & DENOM  DEGREES  (.DR  SOURCE)  : £ 3 


ENTER  3 NUMER  CDEFF— HI 
> 100  1000  1600 

TO 

LO: 

OLTF  NUM  C 

DEFFICIENTS 

OLTF  ZEROS  <OLZERO) 

< 100.0 

)S*^  £ 

-£.  000  ) + J<  0. 

) 

< 1000. 

)S*^  1 

< 

-8.000  ) J<  0. 

) 

< 1600. 

> 

POLYNOMIAL  CONSTANT®  100.0 

ENTER  4 DENOM  COEFF — HI 

TO 

LO: 

> 1 £6  154 

630 

OLTF  DENOM 

COEFFICIENTS 

OLTF  POLES  (OLPOLE) 

< 1.000 

) S^^  3 

< 

-3. 000  ) + JC  5.  000 

> 

< 26.00 

)S^^  £ 

< 

-3. 000  ) + J ( -5. 000 

< 154.0 

)S^^  1 

-£0.00  ) J<  0. 

> 

< 680.0 

POLYNOMIAL  CONSTANT®  l.OOO 

GftIN=  1.0  OLK.=  GRIN^(0LNK>DLDK>=  100. 


OPTION  > 


The  user  also  has  the  option,  instead  of  typing  the 
actual  numerator  and/or  denominator  polynomial  itself,  of 
specifying  another  source  of  chose  numbers  if  they  already 
exist  in  some  other  polynomial  in  TOTAL'S  memory.  For  example 
if  the  user  responds,  as  underlined,  to  the  prompt  below i 

ENTER  NUM  DENOM  DEGREES  <0R  SOURCE):  £>POLYR 

it  will  still  be  necessary  to  enter  the  three  numerator 
coefficients,  but  the  denominator  coefficients  will  be 
copied  form  POLYA  automatically. 
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Similarly,  typings 


ENTER  HUM  DENOM  DEGREES  (DR  SOURCE>  : CLNPOLY » PDLYC 

will  tell  TOTAL  to  get  the  numerator  coefficients  from 
CLNPOLY  (Closed -Loop  Numerator  POLYnomial)  and  the  denominator 
polynomial  from  POLYC.  Thus,  once  Information  exists  In  any 
polynomial.  It  is  available  to  any  other  polynomial. 

The  complete  list  of  names  the  user  may  type  Includes i 
POLYA,  POLYB,  POLYC,  POLYD,  GWPOLY,  GDPOLY,  HNPOLY,  HDPOLY, 
OLNPOLY,  OLDPOLY,  CLNPOLY,  and  CLDPOLY.  For  further 
Information  on  these  polynomials,  see  Sections  2.7  and  4. 

QPT^ONS  6 1 — 7j 8 . and  9 1 Factored  form  Input. 

These  options  are  Identical  in  format  and  allow  the  user 
to  Input  GTF,  HTF,  OLTF  and  CLTF  transfer  functions,  respectively, 
in  factored  form. 

For  example.  If  the  user  has  a closed-loop  transfer  function 
(CLTF)  available  as  a set  of  poles  and  zeros,  he  may  Input  It 
using  option  9,  as  shown  on  the  next  page. 

Note  that  the  roots  were  entered  as  actual  x-y  coordinates 
( S'  ♦ Jco values)  In  the  s-plane.  Also,  note  that  the  Input 
roots  (CLZERO  and  CLPOLE)  were  Immediately  expanded  Into 
pol}niomlals  and  the  coefficients  stored  In  corresponding 
arrays  (CLNPOLY  and  CLDPOLY).  The  listing  shown  In  boxes  Is 
suppressed  If  ECHO  mode  Is  off  (see  option  93,  Section  2.10) 
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□PTIDIH  > 9 

FftCTORED  INPUT  DF  CLTF<S> 

ENTER  NUN  DENOM  DEGREES  'DR  SOURCE)  : £>3 
ENTER  NUMERRTOR  CONSTRNT:  100 


ENTER  ERCH  ROOT — RE* IN 
CLZERO<  1>=  -£>  0 
CLZERD<  £>=  -8  > 0 


CLTF  NUM  COEFFICIENTS 

CLTF  ZEROS  (.CLZERO) 

( 100.0 

> Z**  £ 

( 

-£.000  ) + JC 

0. 

) 

< 1000. 

> S^^  1 

< 

-8.000  > + J< 

0. 

) 

< 1600. 

> 

PDLYNOMIRL  CONSTRNT* 

100.  0 

ENTER  DENOMINRTOR  CONSTRNT: 

1 

ENTER  ERCH 

ROOT — RE* IN 

CLPOLE < 1> 

= -3*5 

CLPOLE < £> 

= t -3.000 

) + JC  -5.000  ) 

ASSUMED 

CLPOLE < 3> 

= -£0*  0 

CLTF  DENON 

COEFFICIENTS 

CLTF  POLES  (CLPOLE) 

< 1.000 

3 

( 

-3.000  ) + J( 

5.  000 

) 

< £6.00 

>S*^  £ 

( 

-3.000  ) + J< 

-5. 000 

) 

< 154.0 

> S^^  1 

< 

-£0.00  ) + J( 

0. 

) 

( 680.0 

> 

POLYNOMIRL  CONSTRNT* 

1. 000 

CLK=  <CLNK/CLDK)=  100. 


OPTION  > 


The  user  also  has  the  option,  Instead  of  typing  the 
poles  and/or  zeros  directly,  of  specifying  another  source  of 
those  numbers  If  they  already  exist  In  some  other  array  In 
TOTAL’S  memory.  (For  examples,  see  explanation  under  options 
2,  3,  4,  and  5.)  The  complete  list  of  names  the  user  may 
type  to  specify  a source  Include i ROOTA,  ROOTB,  ROOTC,  ROOTD, 
GZERO,  GPOLE,  HZERO,  HPOLE,  OLZERO,  OLPOLE,  CLZERO,  and  CLPOLE. 
For  further  Information  on  these  root  arrays  see  Section  4. 
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2,2  MATRIX  INPUT  QPTTON.S 
^ OPTION  lOi  List  options. 

This  option  gives  a quick  reference  list  of  options 
10  through  19. 

OPTIONS  11  through  17i  Matrix  Input  options. 

These  options  are  Identical  In  format  and  allow  the  user 
to  Input  AMAT,  BMAT,  CMAT,  DMAT,  KMAT,  FMAT,  and  GMAT,  (as 
defined  under  option  19),  respectively.  For  example,  If  the 
user  wishes  to  Input  BMAT  he  would  use  option  12. 

OPTION  > 

INPUT  OP  C BMfiT  1 MPTPIX: 

ENTER  MfiTPIX  SIZE:  ROWS* COLUMNS  > 3? 4 

ENTER  4 ELEMENTS  PER  ROl.i: 

ROW  1 > 11  12  13  14 


ROW  2 

> 

21  22 

23 

24 

ROW  3 

> 

31  32 

33 

34 

COL 

> 

1 

2 

3 

4 

ROW 

1 

11.00 

12.  00 

13.  00 

14.  00 

2 

21. 00 

22.  00 

23.  00 

24.  00 

3 

31.00 

32.  00 

33.  00 

34.  00 

The  listing  shovm  Inside  the  Inner  box  Is  suppressed  If 
ECHO  mode  Is  off.  (See  option  93,  Section  2.10) 

Note  that  In  the  first  example  there  were  fewer  rows 
than  columns  and  the  user  was  asked  to  enter  BMAT  by  rows 
In  the  case  where  the  opposite  Is  true  the  user  Is  asked  to 
enter  by  columns. 

G 
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\ 


( 


c 


□PTIDN  > IS 

INPUT  DF  C FMFiT  ] MfiTRIX: 

ENTER  MATRIX  SIZE:  ROWS? COLUMNS  > 5>E 

ENTER  5 ELEMENTS  PER  COLUMN: 

COLUMN  1 > 11  £1  31  41  51 

COLUMN  2 > 12  22  32  42  52 


COL  > 
ROW 

1 

2 

1 

11.00 

12.  00 

2 

21.00 

22.  00 

3 

31.00 

32.  00 

4 

41. 00 

42.  00 

5 

51.00 

52.  00 

Once  again  the  Inner  box  is  suppressed  if  ECHO  mode  is  off. 

OPTION  18 1 Help  user  set  up  state-space  system  model. 

This  option  is  a fast  way  to  input  all  the  matrices 
needed  for  a state-space  model.  It  works  in  the  same  manner 
as  inputting  the  matrices  individually  using  options  11  to 
17,  but  it  dimensions  each  matrix  automatically  to  make  it 
conform  with  the  given  system. 

Specifically,  after  stating  whether  the  system  is  to  be 
continuous  (using  AMAT,  BMAT»  CMAT,  DMAT,  and  KMAT)  or 
discrete  (using  FMAT,  GMAT,  CMAT,  DMAT,  and  KMAT),  the  user 
is  asked  to  type  in  the  numbers  of  states  (order  of  system), 
number  of  system  inputs,  and  number  of  system  outputs.  This 
then  determines  the  size  of  each  matrix  and  the  user  is  asked 
for  the  elements  of  each  matrix  in  the  same  way  as  for  options 
11  to  17. 
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OPTION  19t  Explain  the  use  of  the  above  matrices. 
Option  19  simply  prints  the  following  message. 


OPTION  > 19 


EACH  MATRIX  AVAILABLE  TO  THE  USER  IN  OPTIONS  11-17  (TYPE 
10  FOR  LIST)  MAY  BE  USED  AS  A SCRATCH/STORAGE  REGISTER  FOR 
MANIPULATING  MATRICES  USING  OPTIONS  71-79  (TYPE  70  FOR  LIST) 


IN  ADDITION,  THE  MATRICES  MAY  BE  USED  TO  REPRESENT  DIGITAL 
OR  CONTINUOUS  CONTROL  SYSTEMS  ACCORDING  TO  THE  FOLLOWING 
EQUATIONS I 


CONTINUOUS  1 

XDOT(T)  » 

AMAT 

• X(T)  ♦ 

BMAT  • 

U(T) 

Y(T)  . 

CMAT 

• X(T)  ♦ 

DMAT  • 

U(T) 

WHERE 

U(T)  « 

GAIN 

• (R(T)  - 

KMAT  • 

X(T) 

DISCRETEi 

X(K+1)  . 

FMAT 

• X(K)  ♦ 

GMAT  . 

U(K) 

Y(K)  . 

CMAT 

• X(K)  ♦ 

DMAT  . 

U(K) 

U(K)  » 

GAIN 

• (R(K)  - 

KAMT  • 

X(K) 

OPTION  18  IS  AVAILABLE  TO  HELP  THE  NEW  USER  INPUT  THE 
REQUIRED  MATRICES.  THE  MORE  EXPERIENCED  USER  MAY  INPUT 
THEM  DIRECTLY  USING  OPTIONS  11-17. 


OPTION  > 


The  definitions  for  U(T)  and  U(K)  above  are  standard 
state-variable  feedback  equations.  If  the  feedback  Is  not 
in  state-variable  form^  KMAT  may  be  set  equal  to  zero  and  any 
feedback  specified  In  transfer  function  form  as  HTF.  (see  options 
3 and  6,  Section  2.1) 


2.3  BLOCK  DIAGRAM  MANIPULATION  OPTIONS 
OPTION  20 I List  options. 

This  option  gives  a quick  reference  list  of  options 
20  through  29. 

OPTION  21 1 Form  OLTFfromGTF  and  HTF. 

This  option  multiplies  GTF  and  HTF  to  form  OLTF.  The 
open-loop  transfer  function  (OLTF)  Is  defined  In  TOTAL  as 
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i 


OLTF  » GTF  • HTF 

, GNPOLY  HNPOLY 

( GDPOLY  * HDPOLY 

When  option  21  is  executed,  the  following  operations 

are  performed  on  variables  in  TOTAL. 

OLNPOLY  = GNPOLY  • HNPOLY 
OLDPOLY  « GDPOLY  • HDPOLY 
OLNK  » OLNPOLY (1) 

OLDK  » OLDPOLY(l) 

OLK  = GAIN  • OLNK/OLDK 

In  short,  option  21  simply  multiplies  two  transfer  functions 
to  form  a new  transfer  function.  This  feature  is  thus  useful 


for  combining  transfer  functions  in  cascade. 


OPTION  22 » Form  CLTF  from  GTF  and  HTF. 

This  option  forms  the  closed-loop  transfer  function  (CLTF) 
from  a forward  transfer  function  (GTF),  a feedback  transfer 
function  (HTF),  and  a forward  gain  constant  (GAIN)  as  follows i 


CLTF  ■ 


GAIN  • GTF 
i ♦ GAIN  • GTF  • HTF 


GAIN 
1 ♦ GAIN  • 


, GNPOLY 

GDPOLY 

GNPOLY  HNPOLY 
GDPOLY  * HDPOLV 


. GAIN  » GNPOLY  • HDPOLY 

6DP0LV  • HDPOLY  ♦ GAIN  -GNPOLY  • HNPOLV 

ifhere  GAIN  is  some  constant  which  the  user  can  define. 

When  option  22  is  executed,  the  following  operations  are 

performed  on  variables  in  TOTAL. 


I 


11 
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CLNPOLY  = GAIN  • GNPOLY  • HDPOLY 

, CLDPOLY  = GDPOLY  • HDPOLY  ♦ GAIN  • GNPOLY  • HNPOLY 

( CLNK  = CLNPOLY(l) 

CLDK  = CLDPOLY(l) 

CLK  « CLNK/CLDK 

The  user  must  supply  GTFi  HTF,  and  GAIN  prior  to 
selecting  option  22.  (See  Sections  2.1  and  4.1) 

OPTION  23 1 Form  CLTF  from  OLTF  with  unity  feedback. 

If  OLTF  is  a known  open-loop  transfer  function  for  a 
system  with  unity  feedback,  this  option  will  calculate  the 
closed-loop  transfer  function  CLTF  as 


CLTF 


GAIN  » OLTF 
1 ♦GAIN  • OLTF 


( 


GAIN  • 

1 ♦ GAIN 


OLNPOLY 

OLDPOLY 

. qlnpoly 
OLDPOLY 


, GAIN  » OLNPOLY 

OLDPOLY  + GAIN  * OLNPOLY 

where  GAIN  is  some  numerical  constant  which  the  user  can 
define. 

When  option  23  is  executed,  the  following  operations 
are  performed  on  variables  in  TOTAL. 


CLNPOLY  = GAIN  • OLNPOLY 
CLDPOLY  = OLDPOLY  + GAIN  • OLNPOLY 
CLNK  - CLNPOLY(l) 

CLDK  » CLDPOLY(l) 

CLK  ■ CLNK/CLDK 


I 

I 


u 


T 
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OPTION  24 1 Form  CLTF  from  GTF  ♦ HTF  (parallel) 

If  GTF  and  HTF  are  two  forward  transfer  functions  with 
the  same  input  and  outputs  which  are  summed*  this  option  forms 
a combined  transfer  function  (CLTF)  as  follows i 


HTF 

. 1 

1 

♦ \ 

J 

GTF 

J ^ 

CLTF  ■ GTF  ♦ 

HTF 

GNPOLY  . HNPOLY 
GDPOLY  HDPOLY 

GNPOLY  • HDPOLY  GDPOLY  • HNPOLY 
■ GDPOLY  • HDPOLY 

When  option  24  is  executed,  the  following  operations 

are  performed  on  variables  in  TOTAL. 

CLNPOLY  » GNPOLY  • HDPOLY  + GDPOLY  • HNPOLY 
CLDPOLY  = GDPOLY  • HDPOLY 
CLNK  = CLNPOLY (1) 

CLDK  k CLDPOLY(l) 

CLK  » CLNK/CLDK 

The  user  must  supply  GTF  and  HTF  prior  to  selecting  option 


25.  (See  Section  2.1) 


OPTION  25 1 


Form  GTF(s)  and  HTF(s)  from  continuous 


Given  a state- space  representation  of  the  form 

i(t)  - (AMAT)x(t)  ♦ (BMAT)u(t) 
l(t)  - (CMAT)x(t)  ♦ (DMAT)u(t) 

I “ 

j with  state- variable  feedback 

U(t)  » GAIN  • (E(t)  - (KMAT)x(t)) 
option  25  computes  the  forward  transfer  function  GTF  between 


C 

4 


L 


t 


i I 

i ! 

i I 


i 

\ 

t 
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inpuc  1 and  output  J as 


GTF  = c ^(sl  - AMAT)'^b  ♦ d 

and  the  equivalent  feedback  transfer  function  from  output  j 


to  input  i as 


:sl  - AMAT^ 


c^(sl  - AMAT)b  + d 


where 


b = i th  column  of  BMAT 

c^*  j th  row  of  CMAT 
d * ij  th  element  of  DMAT 

k^=  i th  row  of  KMAT 

Using  option  25  is  a simple  matter.  The  user  first 
supplies  five  matrices  using  options  11,  12,  13,  14,  and  15 
(or  option  18) i 


AMAT(NA,MA)  Continuous  system  matrix 
BMAT(NB,MB)  Continuous  input  distribution  matrix 
CMAT(NC,MC)  Output  matrix 
DMAT(ND,MD)  Direct-transmission  matrix 
K?1AT(NK,MK)  State  variable  feedback  matrix 


»diere 

NAaMAaMC=MK=  Number  of  states 
MB  * MD  a NK  = Number  of  inputs 

NC  ■ ND  a Number  of  outputs 

(NOTEi  For  single  input-single  output  (SISO)  systems,  BMAT 

becomes  an  NB  by  1 column  matrix,  CMAT  becomes  a 1 by  MC  row 

matrix,  DMAT  becomes  a scalar,  and  KMAT  reduces  to  a 1 by  MK 

row  matrix.) 

After  the  system  matrices  are  set  up,  the  user  simply 
selects  option  25.  If  the  system  is  not  SISO,  TOTAL  will  ask 
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which  transfer  functions  are  desired  (between  which  input  and 
which  output)  and  then  store  the  results  in  GIF  and  HTF. 

When  option  25  is  executed,  the  following  operations  are 
performed  on  variables  in  TOTAL i 

GNPOLY  = (CMAT)  • adj(sl  - AMAT)  • (BMAT)  ♦ (DMAT) 

GDPOLY  = detCsI  - AMAT) 

HNPOLY  = (KMAT)  • adj(sl  - AMAT)  • (BMAT) 

HDPOLY  = GNPOLY 

GNK  » GNPOLY(l)  HNK  = HNPOLY(l) 

GDK  ■ GDPOLYCl)  HDK  » HDPOLY U) 

GK  * GNK/GDK  HK  = HNK/HDK 

and,  as  always,  the  roots  of  GNPOLY,  GDPOLY,  HNPOLY,  and 

HDPOLY  are  automatically  stored  in  GZERO,  GPOLE,  HZERO  and 

HPOLE  respectively. 

OPTION  26 1 Form  GTF(z)  and  HTF(z)  from  discrete 
state-space. 

Option  26  functions  exactly  like  25  except  that  FMAT 
and  GMAT  are  used  in  place  of  AMAT  and  BMAT.  (If  the  same 
data  are  used,  identical  transfer  functions  result.)  Option 
26  is  Intended  to  reduce  a discrete  model  of  the  following 
form  to  transfer  functions  in  z-plane. 

x(k  ♦ 1)  » (FMAT)x(k)  ♦ (GMAT)u(k) 
i(k)  = (CMAT)x(k)  ♦ (DMAT)u(k) 
u(k)  « GAIN  • (r(k)  - (KMAT)x(k)) 


The  adjoint  of  (si  - AMAT)  is  a matrix  of  polynomials  in 
s (or  z)  which  is  useful  in  computing  the  resolvant  matrix: 

(.1  - AMAT)-! . 

Option  27  tabulates  each  element  of  the  adjoint  matrix 
(adj(8l  - AMAT))  as  a column  of  polynomial  coefficients  listed 


from  highest  to  lowest  power  and  writes  them  to  local  file 
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ANSWER  for  later  disposition  to  a line  printer. 


? 


( 


For  example,  given  the  matrix 


AMAT  * 


-10  0 
1-2  0 
-2  0 -3 


the  corresponding  adjoint  matrix  is 


adj(sl  - AMAT) 


2 

s + 5s  + 6 0 

s ♦ 3 s^  ♦ 4s  + 3 

-2s  - 4 0 


and  option  27  tabulates  it  as  follows i 


0 

0 

3^  3s  ♦ 2 


1.00 

1 

1 

0. 

1 

1 

0. 

s** 

2 

5.00 

0. 

1 

0. 

s** 

1 

4.00 

* 

0. 

1 

1 

1 

- -L  _ . 
1 

0. 

s** 

0 

0. 

1.00 

1 

1 

0. 

s#* 

2 

1.00 

1 

4.00 

1 

0. 

s«« 

1 

3.00 

1 

1 

1 

— r - 

3.00 

1 

1 

-4-  - 

1 

0. 

s** 

0 

0. 

0. 

1 

1 

1.00 

s»« 

2 

-2.00 

0. 

1 

3.00 

s** 

1 

-4.00 

0. 

1 

1 

2.00 

s«» 

0 

The  numerator  and  denominator  of  each  element  in  the 
resolvant  matrix  can  thus  be  obtained  using  option  27  ito 
find  adj(sl  - AMAT)  and  option  71  (to  find  det(sl  - AMAT), 
respectively. 

OPTION  28 1 Guillemin-Truxal  cascade  compensator  design. 

The  Guillemin-Truxal  cascade  compensator  design  technique 
involves  selecting  a desired  closed-loop  transfer  function 

C 
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(CLTF)  for  a knovm  plant  (GTF)  and  then  finding  a cascade 
compensator  (HTF)  that,  with  unity  feedback,  will  give  the 
desired  CLTF.  (See  D'Azzo  and  Houpis,  Linear  Control  System 
Analysis  and  Design,  pp  408-410). 


HTF 


GTF 


Option  28  simply  solves  for  the  HTF  that  will  give  the 
desired  results  as  follows: 


aiF  * 


GTF  * HTF 
1 GTF  * HTF 


or 


CLNPOLY 


GNPOLY 

GDPOLY 


* HTF 


1 ♦ 


GNPOLY 

GDPOLY 


* HTF 


or,  solving  for  HTFi 


^ HNPOLY GDPOLY  * CLNPOLY 

HDPOLY  ■ GNPOLY  * (CLDPOLY  - CLNPOLY) 

The  user  must  supply  GTF  and  CLTF  prior  to  selecting 
option  28.  (See  Section  2.1) 

OPTION  29 1 Guillemin-Truxal  feedback  compensator  design. 

The  Guillemin-Truxal  feedback  compensator  design 
technique  involves  selecting  a desired  closed-loop  transfer 
function  (CI.TF)  for  a known  plant  (CTF)  and  then  finding  a 
compensator  (HTF)  that  will  give  the  desired  CLTF. 
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Option  29  simply  solves  for  the  HTF  that  will  give  the 

desired  results  as  follows: 

TIT  GTF 

1 ♦ GTF  * HTF 


or 


GNPOLY 

CLNPOLY  GDPOLY 

CLDPOLY  “ , . GNPOLY  .. 

1 ♦ V * HTF 


or,  solving  for  HTF, 

HTF  _ HNPOLY  _ GNPOLY  * CLDPOLY  - GDPOLY  * CLNPOLY 
HDPOLY  ' GNPOLY  * CLNPOLY 

The  user  must  supply  GTF  and  CLTF  prior  to  selecting 

option  29.  (See  Section  2.1) 


2.4  TIME  RESPONSE  OPTIONS 

The  next  ten  options  (30-39)  perform  continuous 
or  discrete  time  response  analysis  of  either  open  or 
closed-loop  transfer  functions.  To  make  fullest  use  of  these 
options,  the  user  should  be  aware  of  three  Important  mode 
control  switches!  CLOSED,  ANSWER,  and  TSAMP.  These  switches 
are  described  In  the  following  paragraphs. 


I 


t 


i 

! 


I 
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CLOSED  Is  a switch  which  determines  whether  the  response 
calculated  will  be  that  of  the  open-loop  transfer  function 
(OLTF)  or  the  closed-loop  transfer  function  (CLTF) . Typing 
"CLOSED,  ON"  selectes  CLTF  while  "CLOSED,  OFF"  selects  OLTF. 
Similarly,  typing  "ANSWER,  ON"  will  cause  all  output  to  be 
written  to  a local  file  ANSWER  while  "ANSWER,  OFF"  displays 
the  output  at  the  user's  terminal.  For  further  information 
on  these  switches,  see  option  93.  (Section  2.10) 

TSAMP  Is  not  truely  a switch  In  the  on-off  sense.  It 
is  a variable  containing  the  value  of  the  sampling  time  in 
seconds.  When  TSAMP  = 0,  TOTAL  assumes  that  the  system  to  be 
analyzed  is  continuous  and  expressed  in  terms  of  the  Laplace 
operator  s.  If  TSAMP  is  Riven  some  positive  value,  the  system 
is  considered  to  be  discrete  in  terms  of  the  z-transform 
operator  z with  the  specified  sampling  time. 

Note  that  all  switches  must  be  set  while  still  in 
OPTION  mode  before  typing  the  desired  option  number.  For 
example,  typing:  OPTION > ANSWER.  ON  CLOSED.  OFF  TSAMP  = .05 
31  will  execute  option  31  with  the  switches  set  as  shown. 
Switches  always  remain  as  set  until  changed  by  the  user  and 
need  not  be  retyped  before  every  option. 

Prior  to  selecting  any  option,  the  user  must  supply  a 
transfer  function  using  an  appropriate  input  option  (options 
0-9i  Section  2.1)  Functions  are  restricted  to  no  more  than 
one  repeated  root  which  must  be  real.  For  the  continuous  case, 
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the  number  of  zeros  must  be  less  than  the  total  number  of  poles 
and  not  more  than  one  greater  than  the  number  of  non-repeated 
poles.  For  discrete  responses,  the  order  of  the  numerator 
must  not  exceed  that  of  the  denominator. 

OPTION  30 » List  options. 

This  option  gives  a quick  reference  list  of  options  30 
through  39. 

OPTION  31 1 Tabular  listing  of  F(T)  or  FlK). 

This  option  provides  a tabular  listing  of  the 
time  response  values  over  a specified  range  of  time.  For 
continuous  responses  (TSAMP  * 0),  the  user  is  asked  to  specify 
an  initial  time,  final  time,  and  the  desired  time  increment, 
and  the  values  of  T and  F(T)  are  tabulated.  For  discrete 
responses  (TSAMP  4 0),  where  CLTF  or  OLTF  has  been  supplied 
as  a z-transfer  function,  the  user  is  asked  to  enter  the 
initial  K,  final  K,  and  K increment  for  F(K)  where  K is  an 
index  corresponding  to  a time  T = K * TSAMP.  In  this  case  K, 
F(K),  input  R(K),  and  K * TSAMP  are  tabulated  as  shown 
below  for  a pulse  input  and 

CLTF(z)  * ^2  4 0.2)(z*-^Q.7  ♦“jC).2) 

The  input  R(K)  for  either  continuous  or  discrete  systems 
may  be  selected  using  option  39. 
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OPTION  32 j 

Plot  F(T) 

or  F(K) 

at 

user ' s 

terminal . 

This  option  prints  out  a 6 by  8 inch  plot  of  F(T)  over 
an  Interval  of  time  specified  by  the  user.  The  F(T)  and  T 
axes  are  scaled  Identically  to  those  of  the  Calcomp  plot  In 
option  34  and  thus  this  option  may  be  used  to  preview  (within 
limits  of  printer  resolution)  exactly  how  a Calcomp  plot 
using  option  34  would  appear. 

For  discrete  systems  (TSAMP  i 0),  F(K)  Is  plotted.  In 
this  case,  the  plot  will  not  be  8 inches  long.  Instead,  the 
Increment  of  K that  is  plotted  will  be  selected  so  that  the 
plot  length  will  never  exceed  8 Inches. 

F(T)  and  F(K)  are  normally  scaled  automatically,  however, 
the  user  may  select  his  own  scale  by  typing  SCALE,  OFF  prior 
to  selecting  the  option. 
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EN  TEC  I NIT  I PL  Tlf'E.  PINPL  Tlr-.r  > 0 3 ' 


PEGICN  CP  i:PLCULP'>'ICN:  T=  0. 

F-T-=  0. 


TO  T=  ■ 2.vQ^^ 

TO  P(T>=  1.50' 
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GRID  SCPLE:  T-PXI5:  .2000 

F<T>  AXIS:  .2500 


JECONCS  DIVISION 
UNITS^DIVISICN 
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A sample  plot  Is  shown  on  the  preceeding  page. 


OPTION  33 t Printer  plot. 

This  option  is  identical  to  option  32  except  that  the 
plot  generated  is  twice  as  wide,  tv/ice  as  long,  and  intended 
exclusively  for  disposition  to  a line  printer.  The  plot  is 
always  written  to  a local  file  called  ANSWER  (regardless  of 
%^ether  the  switch  ANSWER  is  on  or  off).  After  execution  of 
TOTAL  has  been  terminated,  the  user  may  send  the  file  ANSWER 
to  the  printer  using  the  ROUTE  or  DISPOSE  commands. 

OPTION  34 t Calcomo  plot  of  F(T)  or  F(K^ . 

This  option  produces  a Calcomp  plot  and  Stores  it  in  a 
local  file  PLOT  which  the  user  can  later  dispose  to  the 
plotter  when  TOTAL  has  been  terminated. 

The  user  is  first  asked  to  enter  the  initial  and  final 
time  to  be  plotted.  Since  the  time  axis  will  have  ten  divisions 
on  the  plot,  it  is  usually  wise  to  select  the  duration  of  the 
plot  to  be  a number  evenly  divisible  by  ten.  If  the  switch 
SCALE  is  on,  TOTAL  will  automatically  scale  the  magnitude 
axis  to  even  divisions  which  will  extend  over  the  range  of  the 
function  in  the  region  of  time  to  be  plotted.  If  SCALE  is 
off,  the  user  will  be  asked  to  specify  the  minimum  and  maximum 
axis  values.  In  this  case,  since  the  F(T)  axis  is  always  six 
divisions  long,  the  axis  length  should  be  chosen  to  be  evenly 
divisible  by  six  for  best  results. 

Finally  the  user  is  asked  to  input  a title  to  be  drawn 
above  the  plot.  The  title  may  have  up  to  50  characters. 
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A guide  which  is  50  characters  long  (including  the  brackets) 
is  printed  to  aid  the  user  as  shown  below; 
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[ EHTEP  title  LHHFhCTEFT  MH'-  • ] ■ 

SFiMF'LE  title  u:ihb  RLL  50  CHhPhCTEPS  PT.  RM  E::hMPLE 

If  no  title  is  desired  the  user  may  simply  enter  a 
blank  space. 

TOTAL  also  provides  the  capability  for  drawing  more  than 
one  plot  on  the  same  set  of  axes.  After  MULT,  ON  has  been 
typed,  all  subsequent  plots  are  placed  on  the  next  set  of  axes. 
This  will  continue  until  MULT,  OFF  is  typed  or  until  a plot 
other  than  a time  response  (i.e.  root  locus  or  frequency 
response)  is  generated.  When  multiple  plots  are  drawn,  the 
F(T)  axis  is  scaled  to  the  maximum  and  minimum  values  of  the 
first  response  plotted.  If  subsequent  plots  exceed  the  axis 
range  clipping  will  occur,  so  it  is  recommended  that  the 
largest  plot  be  drawn  first  (or  a large  enough  axis  specified 
with  SCALE,  OFF). 

The  physical  size  of  the  plot  may  be  controlled  by  setting 
the  variable  FACTOR  equal  to  the  desired  scale.  Normally,  with 
FACTOR  = 1,  the  plot  will  be  6 x 9 inches.  Typing  FACTOR  = 2 
before  selecting  the  option  number  will  double  the  size  of  all 
future  plots.  FACTOR  =0.5  will  reduce  the  plot  to  half  size. 

It  is  recommended  that  the  user  end  TOTAL  after  every 
four  or  five  plots  and  dispose  them  to  the  plotter  to  avoid 
incurring  the  wrath  of  the  computer  Installation  operator. 
(TOTAL  can  always  be  restarted  without  loss  of  information  by 


1 


i 
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using  option  1 to  recover  all  data  stored  In  MEMORY.)  Grid 

lines  will  be  drawn  on  all  plots  whenever  the  switch  GRID  Is 

ON.  (See  option  93,  Section  2.10) 

OPTION  35 t Print  time  or  difference  equation. 

If  the  system  Is  continuous  (TSAMP  = 0),  option  35  will 

print  the  time  function  as  followsi 

THE  TIHE  FUHCTIOr-  1 1 
F ■ T ■ = 

-4. 4444  T EXP  ' -5.  OCipO  T ' 

- 1 4 P 1 S E : • ' P ■ - 5 . 0 0 0 0 T 

EXP':-E.U000  T>  Clh'  6.  0000  ♦T-^  l£4.t.H5.> 

1.  00  00  E',-,P'  0.  T-' 


For  discrete  systems  (TSAMP  i 0),  the  difference  equation 
corresponding  to  CLTF(z)  = F(z)/R(z)  is  printedi 


F ■:K>  = 


6 . 0 0 0 0 0 0 0 


>^P':f 

> ♦F' ' 1 

> ♦P  '4 
♦P  '4 


- 1 . £ 0 0 0 0 0 0 
. £5  0 0 0 0 0 0 
. 1 0600000 


♦F'K-  1' 
♦ F.K-  £••■ 
♦F '.,K- 


OPTION  36 » Partial  fraction  expansion  of  CLTF_(or_OLTF.l. 

t 

This  option  performs  the  partial  fraction  expansion  of 
a transfer  function  In  s or  z providing  that  the  order  of  the 
numerator  Is  less  than  the  denominator  and  there  Is  no  more 
than  one  repeated  pole.  For  example, 


CLTF(8) 


expands  V.o 


lOOQCs  ♦ 4) 

s(s  ♦ 10)^(s  ♦ 2 1 j6) 


-0.78  - 0.29  . -0.78  ♦ 0.29 

♦ s ♦ 2 - j<r  ♦ s ♦ 2 ♦ 


and  Is  tabulated  by  option  36  as  shown  bn^Che  next  page. 
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Note  that  a pole  at  the  origin  due  to  the  presence  of  a 
step  input  was  included.  Option  39  may  be  used  to  select  an 
impulse  input  if  this  pole  is  not  desired. 

OPTION  37 « List  time  response  figures  of  merit. 

Option  37  computes  most  of  the  characteristics  of  a time 
response  that  are  of  interest  to  the  user  including  rise  time 
(the  time  to  go  from  10%  to  90%  of  the  final  value),  duplication 
time  (time  from  zero  to  first  intersection  with  the  final  value) 
peak  time  (time  to  reach  hiRhest  peak),  setting  time  (last  time 
at  which  the  response  was  outside  a 2%  envelope  around  its 
final  value),  peak  value  (magnitude  of  highest  peak),  and  the 
final  value  of  the  response  as  time  approaches  infinity. 

CPTIDh  37_ 

CDh'^IhljDU::  TIME  FETPDMTE  POP  CLTF'S:;. 

I.IITH  ITEP  IMPljT  DP  'TPEriC’TH  = 1. 


PISE  TIME; 

TP- 

. 1 8 05  08 

IiiJPLICRTIDM  TIME: 

Tri= 

. 3 0 03 1 8 

PERI  TIME; 

TP- 

. 588441 

8ETTLIMC-.  TIME: 

TS- 

8. 18580 

PERK  VRLL'E; 

MF- 

1.58715 

FIMRL  VRLUE; 

FV= 

1 . 0 0 0 0 0 

A sample  output;:  for  an  underdamped  system  is  shown  above. 
OPTION  38 I Quick  sketch  at  user *3  terminal. 

Option  38  is  similar  to  option  32  except  that  the  user  can 

specify  initial  time  (final  time,  and  the  time  increment  to  be 
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plotted  (thereby  controlling  the  length  and  resolution  of  the 
plot.)  In  addition,  the  plot  is  automatically  scaled  to  use 
the  entire  width  of  the  paper  giving  maximum  resolution,  but 
usually  resulting  in  unusual  scale  divisions.  This  option  is 
primarily  intended  for  the  user  who  is  only  interested  in  a 
quick  sketch  of  the  general  shape  of  the  response  curve  and 
not  in  reading  values  off  the  plot. 

OPTION  39 : Select  step,  ramp,  impulse,  pulse,  or  sine  input , 

The  default  input  for  all  time  response  options  is  a unit 
step  function,  however,  the  user  may  select  other  inputs  using 
option  39.  If  TOTAL  is  in  continuous  mode  (TSAMP  = 0)  when 
this  option  is  selected  the  user  is  asked  to  input  ramp  slope, 
pulse  width,  etc.,  in  seconds.  For  discrete  mode  (TSAMP  ^ 0) 
these  variables  are  input  in  terms  of  number  of  samples. 

2.5  ROOT  LOCUS  OPTIONS 

Option  40  through  49  provide  the  user  with  a variety  of 
tools  for  studying  the  root  locus  of  the  open-loop  transfer 
function  (OLTF).  In  order  to  use  this  option  effectively  it 
is  important  that  the  user  understand  thoroughly  the  equations 
and  variables  involved. 

Root  Locus  Fquations 

In  its  simplest  sense,  the  open-loop  transfer  function  is 
just  a ratio  of  two  polynomials  in  s (or  z).  For  example: 

n,  Ti-r-l  - OLNPOI,Y(s)  + 9s  +6 

OLfKs)  - oLDPOL^Cs)  ' TT  

' 2s  + 24s  + 94s  + 120 

Is  a possible  open-loop  transfer  function  where  OLNPOLY  and 
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OLDPOLY  are  array  names  In  TOTAL  containing  the  Open-Loop 
Numerator  POLYnomtal  and  ^en-Loop  Denomiantor  POLYnomial 
coefficients  respectively.  If  these  polynomials  are  factored, 
the  same  transfer  function  can  be  written  as  shown  belowj 


OiTFfs'l  - QLNK  !.  0L2ER0  _ 3 « ( 

OLTFU;  - QL£,j^  . OLPOLE  “ T ‘ (s  ♦ 


s+_Llis  + 2] 
3) (s  +4) (si 


where  OLPOLE  and  OLZERO  are  complex  arrays  of  pole  and  zero 
coordinates  in  the  s- plane.  OLNK  (the  Open- Loop  Numerator 
constant)  and  OLDK  (the  Open-IiOop  Denominator  constant) 
together  comprise  the  total  fixed  open-loop  gain  (OLNK/OLDK) . 

However,  the  entire  concept  of  root  locus  centers  around 
varying  the  overall  open-loop  gain  (static  loop  sensitivity) 
and  observing  how  the  poles  of  the  closed-loop  system  move  in 
the  s-plane.  This  static  loop  sensitivity  is  defined  in  TOTAL  as 
OLK  = GAIN  * (OLNK/OLDK) 

where  GAIN  is  an  added  gain  factor  which  is  varied  from  zero 
to  infinity  along  the  root  locus.  Since  the  system  gain 
(OLNK/OLDK)  remains  constant,  OLK  also  varies  from  zero  to 
infinity.  In  fact,  if  OLNK/OLDK  * 1.0,  GAIN  = OLK  is  the 
static  loop  sensitivity.  The  sensitivity  at  a given  point  on 
the  root  locus  is  also  defined  as 

product  of  distances  from  locus  point 

Q,  j.  ^ to  each  pole  in  the  system 

"product  of  distances  from  locus  point 
to  each  zero  in  the  system 

Using  this  definition  of  OLK,  GAIN  is  just  OLK/ ( OLNK/OLDK) . In 
other  words,  GAIN  is  the  amount  of  gain  that  must  be  added  in 
the  open-loop  to  the  fixed  system  gain  (OLNK/OLDK)  to  produce 


the  desired  closed-loop  poles. 
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General  Comments 


The  root  locus  is  computed  one  branch  at  a time  within 
a region  of  the  complex  plane  which  the  user  can  specify. 
Calculations  begin  from  poles  within  the  region  or  locus  points 
on  the  boundaries  and  proceed  until  the  locus  branch  leaves  the 
region  of  calculation  or  terminates  on  a zero.  Locus  points 
are  calcualted  DEL  units  apart  and  printed  every  DELPR  units. 

Option  49  describes  all  of  the  optional  variables  which  may  be 
used  to  adjust  boundaries,  step  sizes,  and  other  program  functions. 

By  typing  ECHO,  OFF  (see  Section  2.10)  the  user  can 
suppress  the  listing  of  poles  and  zeros  at  the  beginning  of  each 
option.  As  always,  if  the  switch  ANSWER  is  on,  output  will  be 
written  to  the  local  file  ANSWER  instead  of  the  user's  terminal. 

Calcomp  Plots 

The  user  can  obtain  a Calcomp  plot  of  the  root  locus 
within  the  specified  region  of  calculation  for  options  41,  42, 

43,  and  48  by  typing  PLOT,  ON  prior  to  selecting  the  option 
number.  After  each  plot,  the  switch  PLOT  is  automatically 
turned  back  off  to  prevent  accidental  generation  of  unwanted 
plots.  More  than  one  root  locus  may  be  drawn  on  the  same  set 
of  axes  by  typing  MULT,  ON  prior  to  generation  of  the  first 
plot.  Plots  will  continue  to  overlap  until  MULT,  OFF  is  typed 
or  until  a plot  other  than  root  locus  (i.e.,  time  or  frequency 
response)  is  generated.  Additional  switches  controlling  plot 
titles,  etc.  are  described  in  option  93. 

Zero-angle  Root  Locus 

The  zero-angle  root  locus  is  automatically  computed 
instead  of  the  usual  180°  locus  whenever  OLK  is  negative. 
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OLK  = GAIN  * (OLNK/OLDK)  < 0 

The  user  can  arrange  this  by  simply  setting  OLK,  GAIN, 
OLNK,  or  OLDK  equal  to  a negative  number.  Similarly,  If  the 
system  gain  (OLNK/OLDK)  Is  negative  and  the  180°  locus  Is 
desired,  the  user  can  make  OLK  positive  by  making  GAIN 
negative,  and  so  on. 

OPTION  40 I List  options. 

This  option  gives  a quick  reference  list  of  options  40 
through  49. 

OPTION  41 1 General  root  locus. 

This  option  computes  each  branch  of  the  open-loop  transfer 
function  (OLTF)  over  a specified  bounded  region  of  the  complex 
(s  or  z)  plane.  Output  consists  of  a tabular  listing  of  locus 
points  for  each  branch  or  sub-branch  of  the  locus  and  a 
Calcomp  plot  (written  to  file  PLOT)  If  the  switch  PLOT  Is  on. 

If  z-plane  Is  selected  (TSAMP  ^ 0)  the  unit  circle  will  be 
drawn  on  the  locus  plot. 

OPTION  42 t Root  locus  with  a GAIN  of  Interest. 

This  option  Is  Identical  to  option  41  except  that  the 
user  Is  asked  to  specify  GAIN  and  GTOL.  GAIN  Is  the  variable 
part  of  the  static  loop  sensitivity  OLKi 

OLK  » GAIN  * (OLNK/OLDK) 

Option  42  calculates  the  exact  values  of  the  closed-loop 
roots  at  the  value  of  GAIN  specified.  As  In  41 , a tabular 
listing  of  points  spaced  DELPR  units  apart  Is  printed,  however 
within  a range  ± GTOL  of  the  value  of  GAIN  specified,  every 
point  calculated  (spaced  DEL  units  apart)  Is  printed. 
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The  user  is  cautioned  that  the  root  calculated  at  the 
apeclfted  GAIN  is  only  the  point  at  the  current  calculation 
step  size,  DEL,  which  is  closest  to  the  value  of  GAIN  specified. 
lo  come  closer  to  the  exact  value.  DEL  must  be  made  smaller. 

If  a Calcomp  plot  Is  requested,  the  roots  at  the  GAIN  of 
Interest  are  marked  on  the  plot. 

OPTION  43i  Root  locus  with  a damping  ratio  of  Interest. 

This  option  Is  similar  to  option  42  except  that  the  GAIN 
of  interest  is  automatically  calculated  at  a value  of  damping  | 

ratio,  ZETA,  which  is  of  interest.  After  the  value  of  GAIN 

j 

is  found  (by  searching  along  a constant  zeta  line  until  an  | 

intersection  with  the  locus  occurs),  option  43  is  identical  to  ! 

option  42.  The  user  is  asked  to  input  the  desired  value  of  j 

ZETA  (between  0 and  0.9),  RAD,  and  GTOL  where  GTOL  has  the  same  ■ 

meaning  as  in  option  42.  The  ZETA  line  may  interesect  the 
locus  more  than  once.  If  the  further  point  is  desired,  RAD 
(the  distance  from  the  origin  at  <^ich  the  zeta  search  starts) 
should  be  set  large  enough  to  miss  the  unwanted  intersection. 

The  user  is  cautioned  that  if  the  intersection  with  the 
locus  occurs  outside  the  specified  boundaries,  the  zeta  search 
(vdiich  stops  at  the  boundary)  will  fail  and  GAIN  will  retain  its  ! 

i 

old  value.  Should  this  happen,  it  is  only  necessary  to  extend 
the  BB  (top)  and  CC  (left)  boundaries  to  include  the  intersection 
and  try  again. 

On  the  Calcomp  plot  a radial  line  will  be  drawn  from  the 

origin  corresponding  to  the  specified  ZETA.  The  roots  at  the 

corresponding  GAIN  of  interest  are  also  marked  on  the  plot. 
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OPTION  44 t List  n points  on  a branch  of  Interest. 

This  option  is  intended  primarily  to  investigate  parts 
of  the  locus  which  are  of  special  interest.  Only  one  branch 
of  the  locus  is  tabulcLcedt  beginning  at  a specified  point 
given  by  input  variables  XSTART  and  YSTART.  The  user  also 
specifies  the  number  of  points  (NPOINTS)  to  be  calculated 
along  the  locus  at  the  current  step  size  DEL.  No  plot  is 
available  with  this  option. 

OPTION  45\  List  all  points  on  a branch  of  interest. 

This  ‘is  similar  to  option  44  except  that  all  points  on  the 
branch  starting  at  XSTART,  YSTART  and  lying  within  the 
specified  boundaries  are  calculated. 

OPTION  46 1 List  locus  roots  at  a GAIN  of  interest. 

This  option  is  a truncated  version  of  option  42.  The 
only  output  is  a list  of  roots  at  the  specified  value  of  GAIN 
of  interest.  No  plot  is  generated. 

OPTION  47 1 List  locus  roots  at  a ZETA  of  interest. 

This  option  is  a truncated  version  of  option  43.  The 
only  output  is  a list  of  roots  at  the  specified  ZETA  of  interest. 
Again,  the  user  is  cautioned  that  if  the  intersection  of  the 
locus  and  zeta  line  occurs  outside  the  specified  boundaries 
it  will  not  be  found.  Extending  the  BB  (top)  and  CC  (left) 
boundaries  will  solve  this  problem. 

OPTION  48 t Plot  root  locus  at  user’s  terminal. 

This  option  produces  a printed  plot  of  the  root  locus 
within  the  specified  boundaries  AA  (right,  BB  (top),  CX  (left). 
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□PTIDh  > Rl=i=l  EE=5  CC=-11  DD=-5  48 


□PTIDN  > RR=-£  BB=3  CC=-S  DD=-3  48 


□PEN-LDOF  (OLTF;)  PDCT  LDCIJ3  USING  OPTION  48 


REGION  OF  CRLCULRT I on-perl:  CC=  -8.00  TO  RR=  -£.00 

IMRj:  riri=  -3.00  TO  BB=  3.00 


♦♦♦♦♦♦♦ 
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if  if  if  if  if  if  if  if  if  if  if  if  if  if  if  if  if  if  it  if  if  if  if  if  if  if  if  if  ^^ifi^  ^ • 


GRID  SCRLE:  >:-RXIS::  1 INCH=  1.0000 

Y-RXIS:  1 INCH*  1.0000 


OPTION  > 
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and  DD  (bottom).  Since  the  plot  is  always  six  divisions  (six 
inches)  wide,  if  the  user  picks  the  right  and  left  boundaries 
to  be  some  multiple  of  six  units  apart,  the  plot  scale  will 
have  nice  even  divisions.  Also,  since  the  locus  below  the 
real  axis  is  identical  to  that  above  it,  the  user  may  often 
find  it  advantageous  to  locate  the  lower  (DD)  boundary  just 
below  the  axis  to  limit  the  number  of  print-out  lines  produced. 

Sometimes  when  pole  and/or  zeros  are  very  close  together, 
not  all  of  them  will  show  up  on  the  plot  due  to  limits  in 
resolution.  Shrinking  the  boundaries  to  include  just  the  area 
of  ijnterest  will  usually  solve  this  problem.  Since  poles  are 
always  placed  on  the  plot  after  the  zeros,  a cancelled  pole- 
zero  pair  will  appear  as  a pole. 

Sample  plots  produced  by  option  48  are  shown  on  the 
preceeding  pages.  Notice  how  the  boundaries  AA,  BB,  CC,  and 
DD  were  set  prior  to  typing  the  option  number. 

OPTION  49 t Print  current  values  of  all  root  locus  variables. 

Option  49  is  designed  to  help  the  user  remember  all  of  the 
special-purpose  variables  and  their  current  values.  These 
variables  are  optional,  but  add  considerably  to  the  power  of  the 
program.  They  may  be  si)ecified  directly  in  OPTION  mode  by 


typing. 

for  example,  "AA  ■ 4,5"  or "GAIN  • 1000" 

etc.  These 

variables  include i 

DEFAULT 

NAME 

PEFIMITION 

value 

AA 

Right  boundary  in  the  complex  plane 

4l.O 

BB 

Top  boundary 

♦3.0 

CC 

Left  boundary 

-5.0 

:lr.. 
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DEFAULT 


NAME  DEFINITION  VALUE 

DD  Lower  boundary  -3.0 

BOUND  A scale  factor  which  multiplies  AA,  BB,  1.0 

CC,  and  DD  by  its  value  when  the  next 
root  locus  option  is  executed  and  then 
resets  itself  to  BOUND  =1.0. 

ZETA  Damping  ratio  of  interest  for  which  0.0 

roots  are  found  in  options  43  and  47. 

RAD  Distance  from  the  origin  at  which  the  0.01 

zeta  intersection  search  is  started. 

GTOL  A region  around  the  gain  of  interest  0.0 

(GAIN)  for  which  extra  locus  points  are 
printed.  If  GTOL  a 0,  no  roots  of 
interest  are  calculated. 

DEL  Calculaticn  step  size  between  locus  points.  0.1 

DELPR  Fbrinting  step  size  between  locus  points.  0.2 

FIGURE  If  FIGURE  4 0,  the  value  of  FIGURE  will  0.0 

be  printed  on  the  Calcomp  plot.  For 
example,  if  FIGURE  = 3,  the  title  "FIGURE 
NUMBER  3"  will  be  drawn.  Subsequent 
plots  are  numbered  4,  5,  etc.,  until 
FIGURE  is  set  back  to  0. 


2.6  FREQUENCY  RESPONSE  OPTIONS 

The  next  ten  options  (50  - 59)  perform  continuous  or 
discrete  frequency  response  analysis  of  either  open  or 
closed-loop  transfer  functions.  To  make  fullest  use  of  these 
options,  the  user  should  be  aware  of  several  important  mode 
control  swltchesi  CLOSED,  ANSWER,  DECIBEL,  DEGREES,  HERTZ, 
and  TSAMP.  With  the  exception  of  TSAMP,  these  switches  are 
set  in  OPTION  mode  by  typing  -CLOSED,  ON"  or  HERTZ,  OFF,  etc. 

CLOSED  selects  either  the  closed-loop  transfer  function 
(CLTF)  or  the  open-loop  transfer  function  (OLTF)  for  analysis. 
ANSWER  controls  whether  the  output  comes  to  the  user's  terminal 

or  goes  to  the  file  ANSWER.  When  DECIBQ.  is  on,  magnitudes  are 
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output  in  decibels^  when  It  is  off,  linear  magnitude  is  output. 
Similarly,  DEGREES  and  HERTZ  select  degrees  vs.  radians  and 
hertz  vs.  radians  per  second  respectively.  See  option  for 
further  information  on  these  switches. 

TSAMP  is  not  actually  a switch  in  the  on-off  sense.  It 
is  a variable  containing  the  value  of  the  sampling  time  in 
seconds.  When  TSAHP  * 0,  TOTAL  assumes  that  the  system  to  be 
analyzed  is  continuous  and  e^cpressed  in  terms  of  the  Laplace 
operator  s.  If  TSAMP  is  given  some  positive  value,  the  system 
is  considered  to  be  discrete  in  terms  of  the  z-transform 
operator  z with  the  specified  sampling  time. 

Note  that  switches  must  be  set  while  in  OPTION  mode  before 

typing  the  desired  option  number.  Switches  remain  as  set  until 

changed  by  the  user  and  need  not  be  retyped  before  every  option. 
( ' 

As  always,  prior  to  selecting  any  option  the  user  must 

supply  a transfer  function  using  an  appropriate  input  option 
(options  0 - 9) . 

OPTION  50 I List  options. 

This  option  provides  a quick  reference  list  of  options 
50  through  59. 

OPTION  51 » Tabular  listing. 

This  option  tabulates  the  magnitude  and  phase  angle  for 
a range  of  frequencies.  The  user  is  asked  to  specify  the 
initial,  final,  and  delta  frequencies  in  hertz  or  radians  per 
second  depending  on  the  switch  HEKTZ.  Units  for  the  tabulated 
magnitude  and  phase  are  dependent  upon  switches  OECIBfLS  and 
O DEGREES  respectively. 
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OPTION  52 1 Two-cycle  scan  of  magnitude. 

Option  52  tabulates  the  response  magnitude  over  two 
cycles  (powers  of  10)  of  frequency.  Fifteen  points  per  cycle 
are  tabulated  at  frequency  Increments  designed  to  space  them 
evenly  over  the  cycle  when  on  a logilthmlc  scale.  The  user  Is 
asked  to  specify  the  power  of  ten  of  the  starting  frequency. 

_2 

For  example,  if  the  desired  starting  frequency  was  0.01  = 10  , 

the  user  would  type  simply  *’-2".  Option  52  would  then  tabulate 
30  points  spaced  logrlthralcally  over  a range  from  0.01  to  1.0. 
Similarly,  typing  "1"  would  specify  the  range  from  10  to  1000. 

Again,  the  units  of  the  variable  tabulated  depends  on 
switches  DECIBELS,  DEGREES,  and  HERTZ.  A sample  option  Is 
shown  below: 


OPTIDH  > ^ 

CLOCED-LODF  FPEOLiEhC'i  PESPOr-’SE 
enter  PDI.€P  of  STPPTING  FPEi?  '-c' 


li.l  1.  F'RI'.-'  SEC.' 

DEC  I DELS. 

1 . 0 0 0 0 0 0 U 

. 1744G1 15 

1.20  0 0 ij  0 0 

. £5167888^ 

1.40  0 0 0 0 0 

. 343£7559 

1.70  0 0 0 0 0 

. 5078543c' 

£ . 0 0 0 0 0 0 0 

. 70581074 

£.50  0 0 0 0 0 

1.11 0£G77 

3 . 0 0 0 0 0 0 0 

1 . 6075770 

3 . 5 0 0 0 0 0 0 

£. 1811476 

4 . 0 0 0 0 0 0 0 

£ . 8388666 

4.50  0 0 0 0 0 

3 . 5 038376 

5 . 0 0 0 0 0 0 0 

4. 08£3887 

6. 0000000 

4. 3178888 

7. 0000000 

£ . 67 1 0388 

8 . 0 0 0 0 0 0 0 

-.61716858E 

8.  00  0 0 0 0 0 

-£. 6865885 

USING  OPTION  5c 
FDP  .01»  ETC:>  > 0 


t.i  t * P R 1'  ■ "ii  E L ' 

DEC  I PELS 

1 0 . 0 0 0 0 0 0 

-5. 1188336 

1 £ . 0 0 0 0 0 0 

-8. 1381385 

14.  0 0 0 0 j 0 

-1£. 347703 

17.  0 i'  0 0 0 0 

-16. 18517£ 

£ 0 . 0 0 0 0 0 0 

-18. £84 188 

£5 . 0 o 0 0 0 0 

"*■  C*  * J *.*  C* 

3 0 . 0 0 0 0 0 0 

-£6. 73£514 

35 . 0 0 0 0 0 0 

4 0 . 0 0 0 0 0 0 

—31. 866738 

45. 000000 

-33.848576 

50.  0 0 0 0 0 0 

-35.806114 

6 0 . 0 0 0 0 0 0 

-38. 007484 

70.  0 0 0 0 0 0 

-41.705817 

8 0 . 0 0 0 0 0 0 

-44. 0388£3 

80. 000000 

—46 . 084 1 56 

OPTION 
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OPTION  53 1 Two-cvcle  scan  of  phase  angle. 

Option  53  is  Identical  to  52  except  that  phase  angle  Is 
tabulated  instead  of  magnitude. 

OPTION  54 « Plot  magnitude  or  anRle  at  user’s  terminal. 

This  option  prints  out  a 6 x 8 inch  plot  of  magnitude  or 
phase  angle  over  a range  of  frequency  specified  by  the  user. 

The  plot  axis  are  scaled  identically  to  those  of  the  Calcomp 
plots  in  options  55  and  56.  ThuSt  this  pption  may  be  used  to 
preview  (within  limits  of  printer  resolution)  exactly  how  a 
Calcomp  plot  would  appear.  The  magnitude  axis  is  normally 
scaled  automatically  to  easily  interpreted  dimensions,  however, 
the  user  may  select  his  own  scale  when  the  switch  SCALE  is  off. 

OPTION  55 1 Calcomp  plot  Linear  frequency  axis. 

This  option  writes  a Calcomp  plot  to  a local  file  PLOT  for 
later  disposition  to  a plotting  device.  The  linear  frequency 
axis  feature  of  this  option  is  intended  primarily  for  discrete 
frequency  response  plots  where  the  effects  of  aliasing  are 
being  studied  or  for  plotting  small  ranges  of  frequency. 

The  user  is  first  asked  to  enter  the  starting  and  final 
frequencies  to  be  plotted.  Since,  in  this  option,  the  frequency 
axis  will  have  ten  divisions  on  the  plot,  it  is  usually  wise 
to  select  the  axis  range  to  be  some  number  evenly  divisible  by 
ten.  If  the  switch  SCALE  is  on,  the  program  will  automatically 
scale  the  magnitude  axis.  If  SCALE  is  off,  the  user  will  be 
asked  to  specify  the  minimum  and  maximum  axis  values.  Again, 
since  the  magnitude  axis  is  always  six  divisions  long,  the  axis 
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length  should  be  chosen  to  be  evenly  divisible  by  six  for 
best  results. 

The  user  is  also  given  a choice  for  a plot  of  phase, 
magnitude,  or  both  on  the  same  plot. 

A plot  title  of  maximum  length  50  characters  is  also 
requested. 

OPTION  56 1 Calcomp  plot  --  Loe  frequency  axis. 

This  option  is  similar  to  option  55  except  the  frequency 
axis  is  logrlthmic  with  some  Integer  number  of  logrlthmic 
cycles.  The  user  is  asked  to  input  the  power  of  the  starting 
frequency  (-2  for  0.01,  3 for  1000,  etc.)  and  the  number  of 
cycles  to  be  plotted  (maximum  of  ten).  As  in  option  55,  the 
plot  may  be  in  magnitude  or  decibels,  degrees  or  radians,  and 
open  or  closed-loop  depending  on  switch  settings.  Typing 
GRID,  ON  will  place  grid  lines  on  the  Calcomp  plot  as  with  the 
time  response  plots. 

OPTION  57 1 Tabulate  points  of  interest. 

This  option  is  similar  to  option  37.  It  finds  and 
tabulates  all  response  peaks,  zero-db  crossings,  180  degree 
crossings*  break  frequencies,  and  asymtotes  for  the  given 
transfer  function. 

OPTION  58 t Calcomp  plot  --  Nvouest  polar  plot. 

This  option  produces  a polar  plot  of  magnitude  vs.  angle 
%fith  frequency  as  a parameter. 

OPTION  59 t Calcomp  plot  --  Nichol’s  Ior  magnitude /anpAe 
Plot. 

Option  59  produces  a semi-log  plot  of  magnitude  vs.  phase 

angle  with  frequency  as  a parameter. 
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2.7  POLYNOMIAL  OPERATIONS 

There  Is  a large  class  of  control  problems  which  requires 
extensive  manipulation  of  polynomials  and  their  associated 
first-order  factors.  Options  60  through  69  have  been  designed 
to  relieve  the  engineer  of  the  extensive  hand  calculations 
which  would  otherwise  be  necessary  to  solve  these  problems. 

For  complete  understanding  of  these  options,  a few  words  of 
explanation  are  necessary. 

TOTAL  has  twelve  general  purpose  polynomial  arrays  in 
which  the  user  can  store  polynomials  of  maximum  degree  50. 

The  names  by  which  the  user  can  refer  to  these  arrays  are 
POLYA,  POLYB,  POLYC,  POL YD,  GNPOLY,  GDPOLY,  HNPOLY,  HDPOLY, 
OLNPOLY,  OLDPOLY,  CLNPOLY,  and  CLDPOLY.  POLYA  through  POL YD 
are  scratch  registers  used  by  options  61  through  69  for 
polynomial  arithmetic.  The  remaining  eight  polynomials  are 
paired  to  form  four  transfer  functions  GTF,  HTF,  OLTF,  and 
CLTF  and  are  accessed  by  options  throughout  TOTAL. (See  Section 
4.5) 

Corresponding  to  twelve  polynomials  are  twelve  n x 2 
arrays  of  polynomial  roots  where  the  first  dimension  is  the 
root  number  and  the  second  designates  either  the  real  or 
imaginary  part  of  the  root.  The  names  by  which  the  user  can 
refer  to  these  corresponding  root  arrays  arei  ROOTA,  ROOTS, 
ROOTC,  ROOTD,  GZERO,  GPOLE,  lEERO,  HPOLE,  OLZERO,  OLPOLE, 
CLZERO,  and  CLPOLE,  respectively. 

The  important  thing  to  remember  is  that  the  polynomial 


i I 

i i 


and  root  arrays  form  inseparable  pairs  --  changing  one  will 
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change  the  other.  For  example,  changing  a coefficient  in 
( POLYB  will  automatically  change  the  roots  in  ROOTB.  Similarly, 

changing  a root  in  ROOTD  will  result  in  new  coefficients  in 
POLYD,  and  so  on.  Because  of  this  direct  relationship,  the 
pol)momials  and  their  roots  are  always  printed  out  together 
{ as  shown  below t 


:ltf  - s:' 

DEhChlMFTDF 

I 

CLDFOL'i 

1 T ; . 

CLFOLE  ■ r.J 

’J  1 

•'  . 6498 

■d' 

' -.1861  ' + J< 

. 6445 

■:  .4086 

c‘ 

' —.1861  + J ' 

— . 6445 

I: 

.348  0 

1 

' -.3767  + J' 

0. 

. 1 0^6 

1 

CLDF=  . 6' 

198 

The  polynomial  shown  in  this  example  would  read 
CLDPOLY(s)  = 0.6498s^  ♦ 0.4086s^  ♦ 0.3420s  ♦ 0.1056 
and  its  corresponding  factors  as 

^ = 0.6498(s  ♦ 0.1261  - j0.6445)(s  ♦ 0.1261  ♦ j0.6445)(s  + 0.3767) 

Note  that  the  polynomial  constant  CLDK  is  equal  to  the 
coefficient  of  the  highest  power  of  s and  is  simply  the  constant 
that  must  be  multiplied  with  all  the  factors  to  yield  the 
original  coefficients  of  the  polynomial. 

Input  of  Polynomials 

When  the  user  selects  options  61  through  65  he  will 
receive  the  prompt: 

ENTER  POLYA  & POLYB  DEGREES  (OR  SOURCE) > 

If  he  vfants  to  type  in  the  coefficients,  he  simply  enters  the 
degree  of  each  polynomial  and  TOTAL  will  ask  him  for  the 
required  coefficients.  On  the  other  hand,  if  one  or  both  of 
the  polynomials  he  wishes  to  enter  are  already  stored  in  one 
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of  the  twelve- polynomial  arrays,  he  simply  types  the  name  of 
that  array  in  place  of  the  polynomial  degree  in  which  case 
TOTAL  will  get  the  needed  information  from  that  "source". 

The  user  may  mix  names  and  numbers  as  needed.  In  fact,  since 
the  names  POLYA  and  ROOTA  refer  to  simply  two  forms  of  the 
same  polynomial,  typing  either  name  will  transfer  the  same 
information.  The  following  examples  show  possible  responses 


to  the  same  prompt; 


ENTER  POLYA 
ENTER  POLYA 
ENTER  POLYA 
ENTER  POLYA 
ENTER  POLYA 


Sc  POLYB  DEGREES 
& POLYB  DEGREES 
& POLYB  DEGREES 
Sc  POLYB  DEGREES 
Sc  POLYB  DEGREES 


(OR  SOURCE) > 
(OR  SOURCE) > 
(OR  SOURCE) > 
(OR  SOURCE) > 
(OR  SOURCE) > 


3,4 

POLYB.  QliEQDf 
POLYC.  4 
CLDPOLY.  EQQIB 
POLYA.  GZERO 


Notice  that  if,  as  in  the  last  example,  the  user  wants  to 
leave  the  contents  of  POLYA  unchanged,  he  simply  types  "POLYA" 
in  the  appropriate  spot. 

After  each  polynomial  is  entered,  it  is  echoed  back  to  the 
user's  terminal.  To  suppress  this  listing,  the  switch  ECHO 
should  be  turned  off  (see  option  93,  Section  2.10) 

OPTION  60;  List  options. 

Option  60  provides  a quick  reference  list  of  options  60 
through  69. 

OPTION  61 1 Factor  a polynomial. 

If  the  user  Is  only  Interested  In  finding  the  roots  of  a 
polynomial,  option  61  is  the  fastest  way.  The  user  simply 
enters  the  polynomial  degree  and  its  coefficients  as  requested. 
Afterwards,  the  polynomial  and  its  roots  remain  stored  in 
POLYA  and  ROOTA,  respectively  for  future  use. 
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OPTION  62 j Add  polynomials . T 

This  option  adds  POLYA  to  POLYli,  factors  the  result,  and  I 

stores  the  coefficients  and  roots  in  POLYC  and  ROOTC  respectively.  ‘ ^ 
OPTION  63 » Subtract  polynomials.  ^ 

I 

Option  63  is  identical  to  62  except  that  POLYB  is  i 

1 

subtracted  from  POLYA.  The  results  are  stored  in  POLYC  and 

ROOTC  for  future  use.  | 

* I 

PINION  64 1 Multiply  polynomials. 

This  option  stores  the  product  of  POLYA  and  POLYB  to  POLYC. 

I 

POLYC  is  then  factored  and  its  roots  are  stored  in  ROOTC.  This  j 

option  is  automatically  aborted  if  the  degree  of  the  resulting 
polynomial  exceeds  50. 

OPTION  65 t Diyjde  polynomials. 

Option  65  diyides  POLYA  by  POLYB  and  stPres  the  quotient 
polynomial  in  POLYC.  If  the  diyision  has  a remainder,  the 
user  is  asked  to  enter  a limit  on  the  number  of  remainder 
terms  to  be  listed  and  the  division  continues  into  negative 
powers  of  s until  the  division  is  complete  or  the  limit  is 
reached.  As  always,  POLYC  is  automatically  factored  into 

} 

ROOTC.  I 

OITION  66 j Store  any  polynomial  to  POLYP . ? 

POLYD  serves  as  a scratch  polynomial  for  storing 
intermediate  results.  For  example,  if  two  pairs  of  polynomials 
are  to  be  multiplied  and  the  results  summed,  POLYD  could  be 
used  to  hold  the  first  product  while  the  second  product  was 
being  formed.  Option  66  simply  asks  the  user  for  the  name 


r 
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! of  the  polynomial  to  be  stored  and  then  copies  It  Into  POL YD.  • 

( The  contents  of  POLYD  may  be  recovered  at  any  time  by  typing 

POLYD  Instead  of  the  degree  when  It  Is  requested.  (See  "Input 
of  polynomials"  In  the  Introduction  to  Section  2.7) 

i 

The  COPY  command  may  be  used  In  place  of  this  option  for 
more  versltlle  manipulation  of  Information.  For  examplei 
typing  COPY,  POLYA,  POLYC  when  In  OPTION  mode  will  copy  the 
contents  of  POLYA  Into  POLYC.  See  Section  3 for  more 
Information  on  this  command. 

OPTION  67 1 Expand  roots  Into  POLYA. 

If  the  user  has  a collection  of  first  order  factors 
which  he  wishes  to  expand  Into  an  n^^  order  polynomial,  he 
should  use  this  option.  After  entering  the  polynomial  degree 
^ (number  of  factors)  he  will  be  asked  to  enter  real  and  I 

Imaginary  parts  of  each  root.  Only  one  root  may  be  typed 
per  line  and  both  real  and  Imaginary  parts  must  be  specified 
as  x-y  coordinates  In  the  complex  plane.  Conjugates,  If  any, 
are  automatically  assumed,  and  each  root  Is  assigned  an  Index 
number  for  future  reference.  The  resulting  n^^  order  polynomial 
and  Its  roots  are  stored  In  POLYA  and  ROOTA  respectively.  j 

OPTION  68 1 Expand  (s  * a)^  Into  POLYA. 

Option  68*  provides  a quick  method  of  expanding  a multiple 
order  real  root  of  the  form  (s  ♦ a)*'  Into  an  n^^  order 
polynomial.  The  user  Is  asked  to  Input  a and  n and  the 
result  Is  stored  In  POLYA. 
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operation  to  perform,  option  69  is  by  far  the  recommended 
procedure.  This  option  is  simply  a three  function  calculator 
which  adds,  subtracts,  and  multiplies  polynomials.  POLYA, 
POLYB,  POLYC,  and  POLYD  are  used  as  a'  four-regtster  stack 
of  polynomials  which  can  be  "rolled",  "exchanged",  and 
manipulated  as  single  numbers  are  handled  In  any  reverse 
polish  notation  calculator. 

Operations  always  occur  between  POLYA  and  POLYB  where 
POLYA  Is  the  bottom  or  "X"  register  of  the  stack.  Typing  a 
for  example,  adds  POLYA  to  POLYB  and  leaves  the  results 
In  POLYA.  The  contents  of  POLYC  then  drop  Into  POLYB  and 
POLYD  Is  copied  Into  POLYC.  The  contents  of  POLYD  remain 
unchanged.  Similarly,  typing  a "-"  subtracts  POLYA  from 
POLYB,  stores  the  results  In  POLYA,  and  drops  the  stack  as 
described  above.  To  multiply  POLYA  and  POLYB  a is  typed. 

The  user  enters  polynomial  calculator  mode  by  selecting 
option  69  and  receives  the  prompt 
COMMAND  OR  DEGREE i 

whereupon  he  may  type  EX,  ROLL,  LIST,  STACK,  ♦,  -,  ★,  $,  the 
name  of  one  of  TOTAL’S  twelve  polynomials,  or  any  number  from 
0 to  so.  The  meaning  of  these  commands  is  described  below: 

The  numbers  0 to  50  refer  to  the  degree  of  a polynomial 
the  user  wishes  to  enter.  After  such  a command,  the  user  Is 
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asked  to  enter  the  appropriate  coefficients  and  the  new 
polynomial  is  placed  in  POLYA.  What  had  been  in  POLYA  gets 

I 

moved  into  POLYB,  shoving  POLYB  into  POLYC  and  POLYC  into 

POLYD.  The  former  contents  of  POLYD  are  lost.  * 

1 

The  user  may  also  enter  the  current  contents  of  any  of 

I 

TOTAL  * s twelve  polynomials  by  simply  typing  the  correct  name 
(as  listed  in  the  introduction  to  section  2-7).  The  ! 

specified  polynomial  is  automatically  shoved  into  POLYA  at  the  , 

bottom  of  the  stack » and  the  contents  of  POLYD  shoved  out  the 
top  of  the  stack  and  lost  as  described  above. 

is  the  command  to  exchange  the  contents  of  POLYA  and 
POLYB.  As  with  all  operations  in  option  69,  the  corresponding 
root  arrays  ROOTA  and  ROOTB  are  also  exchanged. 

ROLL  is  the  command  to  rotate  the  contents  of  the  stack 
down  and  around.  The  following  transfers  occur i POLYB  to 
POLYA,  POLYC  to  POLYB,  POLYD  to  POLYC,  and  the  original 
contents  of  POLYA  to  POLYD.  Note  that  no  information  is  lost.  | 

LIST  lists  the  current  contents  of  POLYA  and  the  correspond- 
ing array  of  roots  ROOTA. 

STACK  lists  all  four  polynomials  in  the  stack  in  four  i 

« I 

« 

columns  with  the  highest  power  coefficients  on  top.  | ' 

To  end  polynomial  calculator  mode,  the  user  types  a $.  | i 

An  example  of  various  calculator  operations  is  given  on  | 

the  following  page.  Items  typed  by  the  user  are  underlined. 

The  user  may  suppress  the  listing  of  commands  at  the  beginning 

I 

by  typing  69,  S when  selecting  the  option.  ; 

I 
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OPTION  > 69 


('  STACK  levels; 

COMMANDS- 

-meanings: 

EX 

— EXCHANGE  POLYA  8 POLYB  1 

polyd 

ROLL 

—ROLL  STACK  DODN 

’ POLYC 

+ - * 

— OPERATIONS 

POLYB 

LIST 

—LIST  POLYA  CONTENTS  |l 

POLYA 

STACK 

— DISPLAY  STACK  CONTENTS  If 

$ 

— END  OPTION  69 

COMMAND  OR  DEGREE: 


ENTER  5 POLYA  COEFF— HI  TO  LO: 
> 12  23  34  45  56 


COMMAND  OR  DEGREE.* 


ENTER  4 POLYA  COEFF--HI  TO  LO: 
>13  5 7 


COMMAND  OR  DEGREE:  5 


ENiER  6 POLYA  COEFF — HI  TO  LO: 
> 100  200  300  400  500  600 


COMMAND  OR  DEGREE:  STACK 


POWER 

POLYA 

POLYB 

POLYC 

POLYD 

5 

100.0 

4 

200.0 

12.00 

* 

3 

300.0 

1.000 

23.00 

0.00 

2 

400.0 

3.000 

31.00 

0.00 

1 

500.0 

5 , 000 

45.00 

0.00 

0 

600.0 

7.000 

56.00 

0.00 

COMMAND 

OR 

DECREE : 

+ 

COMMAND 

OR 

DEGREE : 

STACK 

POWER 

POLYA 

POLYB 

POLYC 

POLYD 

5 

100.0 

1 

4 

200.0 

12.00 

3 

301.0 

23.00 

0.00 

0.00 

2 

403 , 0 

34.00 

0.00 

0.00 

i c 

1 

505.0 

45.00 

0.00 

0.00 

0 

607.0 

56.00 

0.00 

0.00 

COMMAND  OR  DECREE: 
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2.8  MATRIX  OPERATIONS 


Another  large  class  of  control  problems  require  the 
individual  to  add,  subtract,  multiply,  Invert,  transpose,  and 
obtain  the  determinants  of  constant  coefficients  matrices. 

Options  70  through  79  are  designed  to  facilitate  this  process 
by  removing  some  of  the  more  laborous  hand  computations  Involved. 

To  use  these  options,  the  user  must  first  supply  TOTAL 
with  the  necessary  matrices  using  options  10  through  19.  Once 
these  matrices  (of  maximum  size  10  x 10)  have  been  stored  In 
some  of  seven  arrays  (AMAT,  BMAT,  CMAT,  DMAT,  KMAT,  FMAT,  or 
GMAT),  the  user  Is  free  to  manipulate  them  using  the  options 
about  to  be  described. 

OPTION  70 t List  options. 

This  option  provides  a quick  reference  list  of  options  70 
through  79. 

OPTION  71 t Compute  eigenvalues  of  AMAT. 

The  eigenvalues  of  AMAT  are  simply  the  roots  of  the 
characteristic  polynomial  which  is  defined  as  the  determinant 

det(sl  - AMAT) 

Option  71  simply  evaluates  the  above  determinant  as  a 
polynomial  In  s and  stores  the  result  In  POLYA.  POLYA  is  then 
factored  and  Its  roots,  which  are  the  eigenvalues  of  AMAT,  are 
stored  In  ROOTA. 


This  option  adds  AMAT  to  BMAT  and  stores  the  result  In 
CMAT.  Naturally,  AMAT  and  BMAT  must  have  the  same  row  and 
column  dimensions  for  this  operation  to  be  defined. 
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Option  73  Is  Identical  to  72  except  that  BMAT  Is 


» 


( 


subtracted  from  AMAT. 

OPTION  74 t Multiply  matrices. 

Option  74  performs  the  matrix  multiplication 

(CMAT)  = (AMAT)  • (BMAT) 

For  this  operation  to  be  defined,  AMAT  and  BMAT  must  conform. 

That  is,  the  number  of  columns  in  AMAT  must  equal  the  number 
of  rows  in  BMAT.  If  AMAT  is  an  NA  x MA  matrix,  and  BMAT  is  NB 
X MB,  where  MA  = NB,  then  CMAT  will  be  an  NA  x MB  matrix. 

OPTION  75 t Inverse  of  AMAT . 

This  option  calculates  the  inverse  of  AMAT  and  stores  the 
result  in  CMAT.  If  AMAT  is  singular,  an  error  message  is  printed. 

OPTION  76 1 Transpose  of  AMAT. 

The  transpose  of  a matrix  is  formed  by  interchanging  its 
rows  and  columns  so  that,  for  example,  a 3 x 5 matrix  becomes 
a 5 X 3 matrix.  This  option  transposes  AMAT  and  stores  the 
result  in  CMAT. 

OPTION  77 t Identity  matrix. 

The  identity  matrix  is  a square  matrix  with  ones  on  the 
diagonal  and  zeros  elswhere.  This  option  sets  CMAT  equal  to 
a n X n identity  matrix  where  n is  specified  by  the  user.  This 
identity  matrix  may  then  be  moved  to  any  other  matrix  where  it 
is  needed  using  the  COPY  command  described  In  option  79. 

OPTION  78 1 Zero  matrix. 

This  option  may  be  used  to  set  all  the  elements  of  DMAT 
equal  to  zero.  The  user  can  then  zero  any  other  matrix  by 
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copying  the  zeroed  DMAT  Into  It  using  the  COPY  command  described 
In  option  79. 


t 


( 


OPTION  79 I Copy  one  matrix  to  another. 

Option  79  prints  a brief  message  telling  how  to  use  the 
COPY  command. 


The  COPY  command  has  the  following  form 
COPY,  from,  to 

where  "from"  Is  the  name  of  the  matrix  to  be  copied  and  "to” 
Is  the  name  of  the  matrix  to  recleve  the  data. 


For  example, 

OPTION > COPY.  AMAT.  FMAT 

%rill  dimension  FMAT  to  the  same  size  as  AMAT  and  store  each 
element  of  AMAT  to  the  corresponding  element  of  FMAT.  AMAT  Is 
xmaffected  by  this  operation.  Notice  that  the  COPY  command 


Is  typed  when  In  OPTION  mode. 

In  addition  to  the  seven  matrix  names  already  mentioned 
there  are  19  additional  locations  In  mass  storage  on  the  local 


file  MEMAUX.  This  auxiliary  memory  file  brings  the  total 
number  of  addressable  matrices  to  26  --  one  for  each  letter 


In  the  alphabet. 


♦AMAT 

★FMAT 

★KMAT 

PMAT 

UMAT 

*BMAT 

★GMAT 

LMAT 

QMAT 

VMAT 

eCMAT 

HMAT 

^^T 

RMAT 

WMAT 

♦DMAT 

IMAT 

NMAT 

SMAT 

XMAT 

EMAT 

JMAT 

OMAT 

THAT 

YMAT 

2MAT 


The  names  marked  * are  working  registers  which  may  be 


directly  modified  and  manipulated.  They  are  storM  in  local 


file  MEMORY  (see  option  1).  The  remaining  names  in  the  table 


reside  in  MEMAUX  and  are  only  accessable  with  the  COPY  command 

(although  they  may  be  listed  at  the  user's  terminal  as  usual 
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by  typing  their  names) . These  matrices  may  be  used  as 

auxiliary  storage  locations  whenever  needed.  For  example,  the 

following  commands  are  legal i 

COPY,  AMAT,  XMAT 
COPY,  PMAT,  QMAT 
COPY,  ZMAT,  CHAT 

See  Section  3 for  further  Information  on  COPY  and  other 
commands . 


2.9  DIGITIZATION  OPTIONS 

The  next  ten  options  (80-89)  provide  the  user  with  several 
means  of  transforming  back  and  forth  between  digital  and 
continuous  domains.  Both  transfer  function  and  state-space 
techniques  are  provided. 

All  transfer  function  transformations  are  performed 
In-place  on  the  transfer  function  CLTF.  TOTAL  does  not  keep 
track  of  whether  the  current  CLTF  Is  a function  of  s or  z.  It 
Is  simply  treated  as  an  array  of  numbers.  If  an  s to  z 
transformation  is  performed,  TOTAL  assumes  that  CLTF  Is  a 
function  of  s.  For  z to  s transformations,  CLTF  Is  treated 
as  a function  of  z.  In  all  cases,  for  simplicity,  when  the 
contents  of  CLTF  are  listed,  the  dummy  variable  s will  be 
used  to  represent  either  the  Laplace  s or  the  z-transform  z. 

The  user  Is  assumed  to  be  capable  of  the  mental  gymnastics 
necessary  to  substitute  z for  s when  necessary. 

The  state-space  transformations  provided  are  between 

A^MT  and  BMAT  (the  continuous  system  and  Input  matrices)  and 

FMAT  and  GMAT  (the  discrete  system  and  Input  matrices).  All 
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four  of  these  matrices  can  exist  In  TOTAL  at  the  same  time 
In  contrast  to  the  In-place  transformations  between  CLTF(s) 
and  CLTF(2) . In  the  latter  case,  the  user  may  want  to  copy 
the  original  contents  of  CLTF  Into  some  other  location  using 
the  COPY  command,  before  they  are  modified  with  a transformation 


option* 


)PTION  80 I List  potions. 


This  option  provides  a quick  reference  list  of  options 


80  through  89. 


)PTION  81 t CLTF(s)  to  CLTFfz)  by  Impulsj 


lyarlance. 


The  concept  of  Impulse  Invariance  Is  based  on  the  fact 
that  If  CLTF(s)  Is  expanded  Into  partial  fractions 


CLTF(s 


N 

’■  ^ 


S - 8. 


ifhere.  In  general,  Sj^  la  a complex  number 
8 ■ a ♦ Jb 

then  the  corresponding  Impulse  Invariant  z transfer  function 
18  JU8t 


CLTF(2) 


®k^  -1 
1 - e 2 ^ 


irtiere  T i8  the  sampling  time. 

In  other  word8,  a pole  at  s ■ Sj^  In  the  a -plane  transforms 

to  a pole  at  2-plane  and  the  coefficients  of 

the  partial  fraction  expansion  are  equal. 

Option  81  simply  performs  a partial  fraction  expansion  of 

CLTFCs),  moves  the  poles  from  ^ multiplies  the 
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resulting  terms  back  together  to  form  • CLTF(z) . 

The  algorithm  used  does  not  allow  repeated  poles.  An 
approximate  transform  is  still  possible,  however,  if  the 
repeated  poles  are  separated  slightly  before  transformation. 

OPTION  82 » CLTF(s)  to  CLTF(z)  by  first-difference  transform. 

The  first  difference  transformation  involves  the  simple 
substitution 

. 

where  T is  a given  sampling  rate.  Option  82  makes  this 
substitution  into  CLNPOLY(s)  and  CLDPOLY(s)  and  then  reduces 
the  result  to  a simple  ratio  of  two  polynomials  in  z (CLNPOLY(z) 
and  CLDPOLY(z)). 

OPTION  83 1 CLTF(s)  to  CLTF(z)  by  Tustin  transform. 


This  option  is  similar  to  82  except  that  the  substitution 


made  is 


* “ T 


z - 1 
z ♦ 1 


impulse  inve 


This  option  is  Just  the  inverse  of  option  81 . CLTF(z) 
la  expanded  in  partial  fractions,  the  poles  moved  from  z^  to 
^/T)ln(Zj^),  and  the  resulting  fractions  multiplied  together  to 
form  CLTF(s) . Because  of  the  algorithm  used  this  option  will 
only  work  for  z transfer  functions  which  have  at  least  one  zero 
at  the  origin  of  the  z- plane. 


OPTION  85 t 


inverst 


This  option  Is  Just  the  inverse  of  option  82  and  involves 
the  substitution 
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where  T was  the  sampling  rate  used  to  form  the  z-transfer 
function. 


OPTION  86;  ChTF’Cz)  to  CLTF(s)  by  inverse  Tustin  transform. 

This  option  is  just  the  inverse  of  option  83  and  involves 
Che  substitution 

z _ s_f._T/2 

^ ■ s - T/2 

where  T was  the  sampling  rate  used  to  form  the  z-transfer 
function . 

OPTION  87 : Find  FM\T  and  GH\T  from  AM\T  and  BM\T . 

Option  87  uses  a truncated  power  series  method  to 
approximate  FM/\T  (the  discrete  system  matrix)  and  GM\T  (the 
discrete  input  matrix)  from  die  continuous  counterparts  AH\T 
and  BM\T . The  iterations  are  continued  until  an  accuracy  of 
ten  significant  figures  is  obtained  for  all  elements  of  each 
matrix.  This  method  may  therefore  be  considered,  for  practical 
purposes,  to  be  exact. 

OPTION  88 » Compute  FM\T  = exD(AM\TV.-Tl  . 

This  option  computes  Che  component  matrices  of  the  state 
AT 

transition  matrix  e using  the  Cayley-Hamilton  Theorem  (See 
Shaum's  Outline  State  Space  and  Linear  Systems,  pp  101-102)  and 
sets  P'M/\T  = exp(AM\T*T)  for  a value  of  T specified  by  the  user. 

OPTION  89 > General  transformation. 

This  option  is  a generalized  form  of  the  Class  of 
transformation  performed  in  options  82,  83,  85,  and  86.  It 
Involves  the  generalized  substitution 

? ^ A ^ mfA  . s ^ A 


s * ALPHA  • 


z + B 


or 
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ALPHA 


s ♦ B 


f 

I 


w 


( 


where  ALPHA,  A,  and  B are  constants  which  the  user  can 
define  to  perform  any  bilinear  transformation  which  may  be 
of  interest. 


H 

2.10  MISCELLANEOUS  OPT TON q 

" ~ • I 

The  remaining  options  perform  a variety  of  functions, 
some  of  which  are  of  particular  interest.  ' 

OPTION  90 i List  options.  i 

This  option  gives  a quick  reference  list  of  options  90  I 

through  99.  j 

OPTION  91 1 Stoce  all  data  in  TOTAL  to  local  flip  MEMORY.  | 1 

This  option  is  the  direct  counterpart  to  option  1.  * : 

Normally,  all  data  is  automatically  stored  in  MEMORY  when  the 
user  ends  TOTAL  by  typing  STOP.  Option  91  allows  the  user  to 
store  this  data  without  terminating  the  program.  It  is  I 

recommended  that  the  user  use  this  option  from  time  to  time  to  | 

prevent  loss  of  all  information  in  TOTAL  in  the  event  of  an  | I 

abnormal  termination.  (Such  an  occurance  is  supposed  to  be  I ' 

impossible  with  TOTAL,  but  nothing  is  ever  100^.  fool  proof.)  j | 

See  option  1 for  further  information  on  the  use  of  MEMORY.  I i 

OPTION  92 t ; I 

I ‘ 

This  is  a spare-  option  which  was  not  defined  at  the  time  j 

this  edition  of  the  user's  manual  was  prepared. 

SfTION  9? I List  switch  setting... 

This  option  prints  out  the  current  values  of  all  switch 
settings  in  TOTAL.  Typing  HELP,  93  gives  a complete  description  1 
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OPTION  > 92 

( 

TOTAL'S  MODE  CONTROL  SWITCHES  ARE  SET  AT: 


echo: 

OFF 

closed: 

ON 

ANSWER : 

OFF 

hertz: 

OFF 

plot: 

OFF 

degrees: 

ON 

title: 

OFF 

decibels: 

ON 

; caption: 

OFF 

mult: 

OFF 

grid: 

OFF 

scale: 

ON 

I 


) 


FOR  AN  EXPLANATION  OF  THESE  SWITCHES  AND  HOW  TO  SET  THEM 
type:  help f 93 


OPTION  > HELP >93 

TOTAL  HAS  10  SWITCHES  WHICH  CONTROL  ITS  PERFORMANCE.  I! 

THE  USER  MAY  SET  THESE  SWITCHES  WHEN  IN  OPTION  MODE  BY 

typing:  SWITCHNAMEfON  OR  SWITCHNAME > OFF  f; 

THE  SWITCHES  AND  THE  FUNCTIONS  THEY  CONTROL  ARE: 

ANSWER  >0N  CAUSES  ALL  OUTPUT  TO  GO  TO  FILE  ANSWER 
fOFF  DISPLAYS  OUTPUT  AT  USER'S  TERMINAL 
ECHO  »0N  INPUT  IS  ECHOED  BACK  TO  THE  TERMINAL 

fOFF  ECHO  OF  INPUT  IS  SUPPRESSED 
CLOSED  fON  CLOSED-LOOP  (CLTF)  USED  IF  THERE'S  A CHOICE 
fOFF  OPEN-LOOP  TRANSFER  FUNCTION  (OLTF)  IS  USED 
HERTZ  fON  FREQUENCY  IS  INPUT  AND  OUTPUT  IN  HERTZ 
fOFF  FREQUENCY  IS  IN  RADIANS/SEC 
DECIBELS  fON  MAGNITUDES  ARE  IN  DECIBELS=20!|!AL0G10(MAG) 
fOFF  ACTUAL  MAGNITUDE  IS  OUTPUT 
TITLE  fON  AN  ADDITIONAL  TITLE  TO  BE  DRAWN  OUTSIDE  THE 
BORDER  WILL  BE  REQUESTED  WHEN  NEXT  ROOT  LOC 
PLOT  IS  DONE.  TITLE  WILL  BE  DRAWN  ON  ALL 
FUTURE  PLOTS  UNTIL  TITLEfOFF  IS  TYPED.  \ 

CAPTION  fON  A 3-LINE  CAPTION  WILL  BE  REQUESTED  AND 

DRAWN  WHEN  NEXT  ROOT  LOCUS  IS  GENERATED. 
fOFF  THE  OPEN-LOOP  TRANSFER  FN.  IS  DRAWN  ON 
ALL  ROOT  LOCUS  PLOTS. 

PLOT  fON  GENERATES  CALCOMP  PLOT  FOR  OPTIONS  41f42f43fX  48 

fOFF  NO  PLOT  (PLOT  IS  AUTOMATICALLY  TURNED  BACK 
OFF  AFTER  EACH  PLOT) 

MULT  fON  FUTURE  PLOTS  ALL  DRAWN  ON  NEXT  AXIS  SET 
fOFF  EACH  PLOT  IS  DRAWN  SEPARATELY 
GRID  fON  DRAW  GRID  LINES  ON  PLOTS 

fOFF  OMIT  GRID  LINES  ON  PLOTS 
SCALE  fON  AUTO  SCALE  CALCOMP  PLOTS 
fOFF  LET  USER  SPECIFY  SCALE 

note:  IF  A SWITCHNAME  IS  TYPED  WITHOUT  fON  OR  fOFFf 
THE  SWITCH  IS  TURNED  ON. 

OPTION  > 


A -AA 


» 


( 


I 

I 


( 


of  each  switch  and  how  to  use  them.  An  example  of  both  is 
given  on  the  following  page. 

OPTION  94 1 

This  Is  a spare  option  as  yet  undefined. 

OPTION  95 1 

This  option  at  the  time  of  this  writing  Is  as  yet  undefined. 

OPTION  96 t List  special  commands. 

This  option  gives  a brief  list  of  the  special  commands 
that  are  allowed  in  OPTION  mode.  See  Section  3 for  a complete 
description  of  these  commands.  This  same  list  can  be 
generated  by  typing  COMMANDS . 

OPTION  97 > List  variable  name  directory. 

This  option  is  designed  to  serve  as  a memory  aid  for  the 
user  who  Is  trying  to  remember  a particular  variable  name. 

These  variables,  and  how  to  list  and  modify  them  are  discussed 
In  detail  In  Section  4,  This  same  list  of  variables  may  be 
obtained  at  any  time  by  typing  VARIABLES. 

OPTION  98 1 List  main  options. 

This  option- lists  the  ten  main  option  groups  In  TOTAL. 

The  same  list  may  be  obtained  by  typing  the  command i OPTIONS . 

OPTION  99 t Give  the  Introduction  to  TOTAL. 

This  option  gives  a brief  Introduction  to  TOTAL.  It  Is 
the  same  Introduction  obtained  when  the  user  types  HELP. 


! 
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SECTION  3.  SPECIAL  COMMANDS 


TOTAL  has  a number  of  special  commands  which  are  designed 
to  enhance  the  user's  control  of  the  program.  In  the  list 
below,  items  in  capital  letters  are  actual  commands, items  in 
parenthesis  are  optional  parameters,  and  those  in  small  letters 
refer  to  general  command  types.  Underlined  letters  indicate 
the  minimum  abbreviation  which  is  allowed  for  each  item. 


Commands  may  b^^ 


>ed  only  in  OPTION  mode.  (See  Section  1.1) 


The  following  are  the  special  commands i 


STOP.  (SUP) 

HSTp,  (option  number) 

Swtichname,  (ON  or  OFF) 

COPY,  from,  to 
PAGE 

dSTETE,  root  (I),  (VETO) 


CALCULATOR 
CpS’TE, 


CREATE,  keyname,  string 


End  program  (suppress  messages) 
Get  help  on  (specified  option 
number) 

Turn  specified  switch  (on  or 
off) 

Copy  one  variable  to  another 
Skip  to  top  of  new  output  page 
Remove  a specified  pole  or 
zero  (display  its  value  first) 
Delayed  entry  to  calculator  mode 
Define  a macro  with  the  specified 
keyname  to  execute  the  specified 
string  of  commands. 


This  command  stores  all  data  into  local  file  MEMORY, 
writes  messages  to  notify  the  user  of  any  files  that  have  been 
created  during  execution,  and  terminates  TOTAL.  These  messages 
are  suppressed  if  the  user  types  "STOP,  S". 


The  user  may  obtain  help  on  any  option  by  simply  typing 
HELP  followed  by  the  option  ntunber  of  interest.  For  example 

"Hn.P,  38"  will  give  a brief  description  of  option  38. 
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Swltchname,  (ON  or  OFF). 

This  command  allows  the  user  to  set  TOTAL'S  twelve  mode 
control  switches  which  include  ECHO,  ANSWER,  PLOT,  TITLE, 
CAPTION,  GRID,  CLOSED,  HERTZ,  DEGREES,  DECIBELS,  MULT,  and 
SCALE.  These  switches  allow  the  user  to  custom  tailor  TOTAL'S 
performance  to  his  individual  preference.  See  option  93  in 
Section  2.10  for  further  details. 

COPY,  from,  to. 

The  COPY  command  is  a special  utility  which  allows  the 
user  to  transfer  the  contents  of  entire  arrays  from  one 
location  to  another.  COPY  may  be  used  to  copy  transfer 
functions,  polynomials,  or  matrices  to  other  transfer  functions, 
polynomials,  or  matrices  respectively.  The  program  will 
Ignore  attempts  to  copy  a transfer  function  into  a matrix,  etc. 


Transfer  Functions.  TOTAL  has  28  transfer  function 


storage  locations  of  which  GTF,  HTF,  OLTF,  and  CLTF  are  working 
registers  stored  on  local  file  MEMORY  and  the  remainder  are 


auxiliary  registers  stored  on  local  file  MEMAUX  and  are 
accessable  only  with  the  COPY  command.  These  transfer  functions 
includes 


ATF 

ETF 

ITF 

MTF 

QTF 

UTF 

YTF 

BTF 

FTF 

JTF 

NTF 

RTF 

VTF 

ZTF 

CTF 

*GTF 

KTF 

OTF 

STF 

WTF 

★OLTF 

DTF 

*HTH 

LTF 

PTF 

TTF 

XTF 

★CLTF 

Transfers  are  legal  between  any  two  of  the  above  locations. 


For  example,  COPY,  GTF,  XTF  will  transfer  GTF  into  XTF.  GTF 
is  unaffected. 


1 

I 

I 

i 

I 
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Polynomials . Transfer  Is  also  permitted  between  any  two 
of  TOTAL'S  twelve  polynomials  Including  POLYA,  POLYB,  POLYC, 

POLYD,  GNPOLY,  GDPOLY,  HNPOLY,  HDPOLY,  OLNPOLY,  OLDPOLY,  CLNPOLY, ‘ 


and  CLDPOLY.  For  example,  COPY,  POLYA,  CLNPOLY  will  transfer 
the  contents  of  POLYA  Into  CLNPOLY. 

Matrices . Finally,  TOTAL  has  26  matrix  locations  which 
may  be  addressed  by  the  copy  command.  These  matrices  Include i 


i 

*AMAT 

EMAT 

IMAT 

MMAT 

QMAT 

UMAT 

YMAT 

. 

*BMAT 

*FMAT 

JMAT 

NMAT 

RMAT 

VMAT 

ZMAT 

*CMAT 

*GMAT 

*KMAT 

OM/\T 

SMAT 

WMAT 

*DMAT 

HMAT 

LMAT 

PMAT 

TMAT 

XMAT 

Transfer  is  allowed  between  any  two  locations.  For 


example  COPY,  AMAT,  QMAT  copies  AMAT  to  QMAT. 

PAGE. 

This  command  is  primarily  for  use  when  the  switch  ANSWER 
Is  on.  It  places  a "I”  in  column  1 on  the  file  ANSWER  as  a 
carriage  control  character  for  a line  printer.  This  causes 


the  printer  to  skip  to  the  top  of  a new  computer  sheet  before 


« 

C 

£ 


I 


I 


continuing  the  printout.  The  PAGE  command  is  particularly 
useful  for  separating  output  between  different  problems  and 
any  time  a new  sheet  of  paper  is  desired.  To  execute  this 
command  the  user  simply  types  "PAGE" . 

DELETE.  rootCl^.  (VETO). 

The  user  may  modify  the  location  of  a pole  or  zero  at  any 
time  by  simply  typing  its  name,  an  equal  sign,  and  its  new 
value.  A pole  or  zero  can  be  added  in  the  same  manner  by 
simply  naming  the  root  with  the  next  highest  index  number. 

(See  Section  4.3)  However,  to  remove  a root  and  thereby  reduce 


T 


.1 

■I 

il 
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the  order  of  the  system,  the  DELETE  command  is  required.  For 
( example  typing  "DELETE,  CLP0LE(3)"  will  remove  pole  number  3 

from  the  closed-loop  transfer  function  (CLTF),  reduce  the  order 
of  the  system  by  one,  resequence  the  index  numbers  on  the 
remaining  poles,  and  recalculate  the  coefficients  in  CLDPOLY. 

If  CLP0LE(3)  has  a complex  conjugate,  both  roots  will  be  deleted 
and  the  system  order  reduced^  by  two.  If  the  user  does  not  know 
the  index  number  of  the  root  he  wants  to  delete,  he  can  type 
the  array  name  for  a list.  For  example,  typing  "CLPOLE"  would 
list  all  pole  locations  and  their  corresponding  index  numbers. 

The  VETO  command  is  an  optional  suffix.  If  "DELETE, 
CLP0LE(3),  VETO"  were  typed,  the  value  of  CLP0LE(3)  would  be 
printed  and  the  user  asked  to  type  "YES"  or  "NO"  to  delete  or 
not.  This  feature  allows  the  user  to  confirm  that  he  hks 
^ selected  the  right  root  before  completing  the  deletion.  The 

user  may  abbreviate  the  command  as  "D,  CLP0LE(3),  V"  if  desired. 
CALCULATOR. 

This  command  allows  delayed  entry  into  CALCULATOR  mode. 
Calculator  is  normally  entered  by  typing  a simple  "C" . This 
causes  CALCULATOR  mode  to  begin  immediately  when  the  carriage 
return  button  is  pressed,  regardless  of  how  many  commands 
preceed  it  in  the  string.  For  example, 

OPTION  > ECHO.  ON  38  AA«4.5  nD«19 

trill  be  executed  in  this  order > 

C ECHO,  ON  38  AA-4.5  DD-19 
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This  Is  to  allow  the  user  to  jump  directly  to  calculator 


I 


mode  at  any  time.  If,  however,  the  user  wants  to  enter 
calculator  in  the  sequence  he  specified,  he  must  use  an 
abbreviation  longer  than  "C",  such  as  "CALC".  For  example, 
OPTION  > ECHO.  ON  38  AA=4.5  CALC  DD=19 

CREATE,  keyname,  commandstring. 

Using  CREATE,  the  user  can  define  his  own  macro  command 
made  up  of  any  combination  of  option  numbers,  commands, 
variable  names  and  other  macros  which  he  uses  frequently. 

In  other  words,  this  command  makes  TOTAL  programable. 

Three  macro  command  names  (key  names)  are  all owed i AKEY, 
BKEY,  and  CKEY.  Each  key  can  be  made  of  up  to  50  instructions 
to  do  anything  allowed  in  OPTION  mode.  These  instructions  are 
then  executed  like  a subprogram  any  time  the  key  name  is  typed. 

For  example,  if  the  user  wants  to  write  a key  which  will 
turn  ANSWER  on,  change  the  value  of  a pole  to  the  current  value 
in  the  X register  of  the  calculator,  and  plot  a root  locus 
using  option  48,  he  can  typei 

CREATE,  AKEY,  ANSWER,  ON  OLPOLE(2)=X  48 
and  then  hit  the  carriage  return.  From  then  on  he  can  execute 
the  above  sequence  by  simply  typing  "AKEY" . Now,  suppose  he 
wants  to  run  ten  root -loci  in  a row,  each  with  a different 
pole  location.  He  can  typei 

CREATE.  AKEY,  CALC.  OLPOLE(3)«X.  AKEY 
Now  when  he  types  "AKEY" , TOTAL  will  pause  in  calculator  mode 
I to  give  the  user  a chance  to  enter  a number  into  the  X register. 


I 
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After  the  user  types  "C"  to  leave  calculator  mode,  execution 
continues  and  the  pole  location  Is  changed  to  the  number  he 
entered.  The  final  command  In  the  string,  "AKEY",  allows  AKJEY 
to  call  Itself  and  the  sequence  repeats,  stopping  in  CALCULATOR 
mode  for  the  next  pole  location.  This  process  continues  until 
the  user  types  a $ to  abort  the  endless  loop.  The  user  is 
cautioned  that  if  he  does  not  include  a pause  to  request  input 
some  Place  in  the  loop,  he  will  not  have  a chance  to  end  the 
loop  with  a and  will  have  to  abort-,  the  program  completely 
with  a "^A”. 

Since  each  macro  key  can  have  50  steps,  the  user  can  write 
a 150  step  program  by  having  one  key  call  another. 

Macro  keys  are  particularly  useful  for  reducing  large 
complicated  block  diagrams  at  a single  command.  A user  can 
store  each  block  of  the  diagram  into  one  of  TOTAL'S  28 
transfer  function  registers  and  then  write  a key  using  the 
COPY  command  and  options  21,  22,  23,  and  24  to  reduce  the 
diagram  to  a single  transfer  function  for  analysis.  The  user 
can  then  modify  any  variable  in  any  block  and  Instantly  reduce 
it  to  a single  function  with  one  key. 

Other  uses  for  TOTAL'S  three  macro  keys  should  be 
apparent  to  the  user. 
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SECTION  4.  TOTAL'S  VARIABLES 

( 

TOTAL'S  data  base  Is  divided  Into  variables  of  four 
types  I scalar  constants,  polynomial  arrays  of  up  to  51 
coefficients,  root  arrays  of  up  to  50  complex  numbers,  and 
matrices  of  up  to  10  x 10  elements.  Each  of  these  variables 
may  be  listed  by  typing  Its  variable  name.  Variable  values 
may  be  assigned  or  modified  as  described  In  the  following 
sections i 


4.1  SCALAR  VARIABLES 

A list  of  scalar  variable  definitions  Is  given  at  the 

end  of  this  section.  The  user  can  modify  the  values  of  these 

variables  by  simply  setting  the  variable  equal  to  a number  or  ^ 

another  variable.  The  following  list  shows  some  of  the 

possible  ways  to  modify  GAIN,  a typical  scalar  varlablei 

GAIN  Is  set  equal  to  27.98  I 

GAIN  Is  set  equal  to  the  current  value  | 

of  the  scalar  variable  OLK 
GAIN  Is  set  equal  to  the  third  coefficient 
(from  the  highest)  of  POLYA 
GAIN  Is  set  equal  to  the  Imaginary  part 
of  the  first  GTF  zero 

GAIN  Is  set  to  the  real  part  (by  default) 
of  the  third  OLTF  pole 
GAIN  Is  set  equal  to  the  value  of  the 
element  In  the  third  row  and  fourth  t 

column  of  AMAT.  1 


Polynomial  coefficients  are  stored  In  arrays  from  highest 
to  lowest  terms.  For  example,  a second-order  polynomial  stored 

c 
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GAINS  27.98 
GAIN*  OLK 

GAIN*  P0LYA(3)  -- 

GAIN-  GZER0(1,2)-- 

GAIN«  OLPOLEO)  -- 

GAIN-  AMAT(3,4)  -- 

4.2  POLYNOMIAL  ARRAYS 


( 


! 


c 

f 


In  POLYA  would  have  the  form 

POLYA(l)s^  ♦ P0LYA(2)s  ♦ P0LYA(3) 

The  user  may  list  any  coefficient  of  this  polynomial  by 

typing  its  name  "P0LYA(2)"  etc.  Typing  "POLYA"  without 

subscripts  will  list  all  coefficients. 

The  user  can  modify  any  coefficient  by  setting  it  equal 

to  its  desired  value  or  another  variable.  The  following  list 

shows  some  of  the  ways  to  modify  the  second  coefficient  of 

POLYA  (POLYA (2)).  For  example i 

POLYA(2)=3.38  POLYA(2)=HPOLE(2,l ) 

P0LYA(2)=X  P0LYA(2)=HP0LE(2) 

POLYA ( 2 ) =CLNPOLY ( 3 ) POLYA ( 2 ) =DMAT (7,3) 

A list  of  TOTAL'S  twelve  polynomials  and  their  definitions 

is  given  at  the  end  of  this  section.  See  the  introduction  to 

Section  2.7  for  further  information  on  the  use  of  these 

variables . 

4.3  ROOT  ARRAYS 

For  every  polynomial  array  there  is  a corresponding  root 
array  which  contains  a real  and  an  imaginary  part.  The 
root  in  the  ROOTA  array,  for  example,  has  the  form 
R00TA(I,1)  ♦ jR00TA(I,2) 

where  the  second  subscript  designates  the  real  or  imaginary 

part  of  the  root's  location  in  the  complex  plane.  Roots  may 

4lao  be  referred  to  without  the  second  subscript,  in  which  case 

the  real  part  is  assumed.  Typing  "ROOTA"  will  list  all  the 

roots  In  the  array  while  typing  "R00TA(2)"  will  list  only  the 

real  and  imaginary  parts  of  the  second  root. 
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The  real  part  of  the  second  root  In  the  ROOTA  may  be 

modified  in  any  of  the  following  ways. 

R00TA(2,1)=  -2.5  R00TA(2)=  CLP0LE(6,1) 

R00TAr2)=  -2.5  RCX)TA(2,1)=  GAIN 

R00TA(2)=  P0LYA(3)  R00TA(2)=  KMAT(3,2) 

Similarly,  the  imaginary  part  of  the  fourth  open-loop 

zero  would  be  changed  like  thisj 

OLZERO(4,2)=  32.8 
0L2ER0(4,2)=  CLPOLE(3,2) 

OLZERO(4,2)=  GNP0LY(13) 

It  is  possible  to  change  both  real  and  imaginary  parts  of 

a root  at  the  same  time  as  follows i 

HP0LE(3)*  CLP0LE(2)  --  Sets  real  and  imaginary  parts  of 

the  third  HTF  pole  equal  to  the 
real  and  imaginary  parts  of  the 
second  CLTF  pole  respectively 
R00TB(2)=  GZER0(9)  --  Sets  real  and  imaginary  parts  of 

the  second  root  of  POLYA  equal  to 
the  ninth  zero  of  GTF 
CLP0LE(4)=  2. 78 1 9 --  (See  paragraph  below) 

The  reader’s  attention  is  called  to  the  last  example  where 

a semi-colon  was  used  to  separate  the  desired  real  and  imaginary 

values  of  CLP0LE(4).  This  is  a special  notation  which  tells 

TOTAL  to  look  for  another  number  and  assign  it  to  the  next 

variable  in  the  array.  Since  CLP0LE(4,1)  was  set  equal  to 

-2.78,  the  semi-colon  tells  TOTAL  to  set  CLPOLE(4,2)  equal  to 

9.  Without  the  semi-colon,  TOTAL  would  assume  the  9 was  an 

option  number  and  go  execute  option  9f  A list  of  TOTAL'S 

twelve  root  arrays  is  included  in  the  variable  definitions  at 

the  end  of  this  section.  See  the  introduction  to  Section  2.7 

for  further  information  on  the  use  of  these  variables. 
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4.4  MATRIX  ARRAYS 

TOTAL  has  seven  working  matrix  arrays  of  maximum  dimension 

10  X 10  which  may  be  manipulated  directly.  (The  19  auxiliary 

matrices  provided  with  the  COPY  command  (see  Section  3)  can 

only  be  modified  by  first  transferring  their  contents  into 

one  of  the  seven  working  matrices  described  below.)  These 

arrays  are  defined  at  the  end  of  this  section. 

The  user  may  list  any  element  of  a working  matrix  by 

typing  its  name  and  Indlcles.  For  example,  the  element  In  the 

third  row  and  second  column  of  AMAT  is  listed  by  typing 

”AMAT(3,2)".  The  entire  row  can  be  listed  by  typing  AMAT(3). 

To  list  a column,  the  user  must  use  a prefixi  '•C0L,AMAT(2)" . 

Typing  "AMAT"  without  subscripts  will  list  the  entire  matrix. 

(The  19  auxiliary  matrices  may  also  be  listed  in  this  manner, 

but  subscripts  are  not  allowed.) 

To  specify  the  value  of  a particular  element,  say  AMAT(3,2), 

the  user  may  typei 

AMAT(3,2)=  77 
AMAT(3,2)=  X 
AMAT(3,2)=  POLYA(ll) 

and  so  on.  The  special  semi-colon  feature  described  In 
Section  4.3  may  be  used  to  increment  the  column  Index  by  one. 

For  example,  typing i 

AMAT(3,2)=  14;28|64 

would  set  AMAT(3,2)»  14,  AMAT(3,3)=  28  and  AMAT(3,4)«  64.  If 
the  maximum  row  dimension  is  reached  during  such  a string,  TOTAL 
will  move  to  the  first  column  of  the  next  row,  and  so  on. 
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4.5  TRANSFER  FUNCTIONS 

Transfer  functions  In  TOTAL  are  not  separate  storage 
locations,  they  are  just  groups  of  other  variables  as  defined 
below I 

GTF  = GNPOLY/GDPOLY  * (GNK*GZERO) /(GDK*GPOLL"> 

HTF  = HNPOLY/HDPOLY  = (HNK*HZERO) /(HDK*HPOLE) 

OLTF  * OLNPOLY/OLDPOLY  = (OLNK*OLZERO) /(OLDK*OLPOLE) 

CLTF  = CLNPOLY/CLDPOLY  = (CLNK*CLZERO) /(CLDK*CLPOLE) 

The  variables  which  make  up  each  of  these  transfer 
functions  may  be  listed  or  modified  individually  as  described 
in  Sections  4.1,  4.2,  and  4.3.  The  contents  of  every  variable 
associated  with  a particular  transfer  function  may  be  listed 
by  typing  a corresponding  transfer  function  name.  The  contents 
of  all  variables  in  one  transfer  function  may  be  transferred 
to  the  respective  variables  of  another  using  the  COPY  command 
described  in  Section  3. 

The  four  transfer  functions  described  above  are  called 
"working”  transfer  functions  because  their  contents  may  be 
manipulated  directly.  There  are  also  24  auxiliary  transfer 
functions  which  may  be  used  only  for  storage  and  which  cannot 
be  manipulated  directly.  These  auxiliary  storage  locations 
are  accessable  only  with  the  COPY  command  as  described  in 
Section  3. 


i 


I 


I 
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SCALAR  VARIABLE  DEFINITIONS 


PAK 

PBK 

PCK 

PDK 

GNK 

GDK 

HNK 

HDK 

OLNK 

OLDK 

CLNK 

CLDK 


POLYA (1) 

POLYB(l) 

POLYC(l) 

POLYD(l) 

GNPOLY(l) 

GDPOLY(l) 

HNPOLY(l) 

HDPOLY(l) 

OLNPOLY(l) 

OLDPOLY(l) 

CLNPOLYfl) 

CLDPOLY(l) 


Polynomial  A constant 
Polynomial  B constant 
Polynomial  C constant 
Polynomial  D constant 
GTF  numerator  constant 
GTF  denominator  constant 
ITTF  numerator  constant 
HTF  denominator  constant 
OLTF  numerator  constant 
OLTF  denominator  constant 
CLTF  numerator  constant 
CLTF  denominator  constant 


GNK/GDK 

HNK/HDK 

GAIN  * (OLNK/OLDK) 
CLNK/CLDK 


= GAIN  * GK  * HK 


GAIN 

TSAMP 

FACTOR 

X.Y.Z.T 

REGISTER(I) 


Added  gain  in  the  open  loop 
Sampling  time  in  seconds 
Scale  factor  for  calcomp  plot  size 
Calculator  stack  registers 
Subscripted  name  for  referencing  the 
20  scalar  calculator  memory  registers 


The  remaining  scalars  are  special  purpose  root  locus 
variables  and  are  described  in  greater  detail  in  Section  2.5^ 


AA 

BB 

CC 

DD 

BOUND 

ZETA 

RAD 


GTOL 

DEL 

DELPR 

FIGURE 


Right  root  locus  boundary 

Top  root  locus  boundary 

Left  root  locus  boundary 

Bottom  root  locus  boundary 

Boundary  scale  factor 

Damping  ratio  of  interest 

Distance  from  origin  in  s-plane  or  zal  in 

z- plane  along  the  zeta  of  interest  at  which 

the  search  for  a locus  intersection  starts. 

(actually  starting  in  both  planes) 

Range  of  interest  around  GAIN 
Calculation  step  size  between  locus  points 
Printing  step  size  between  locus  points 
Optional  figure  number  on  locus  plots 
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POLYA 

POLYB 

POLYC 

POLYD 

GNPOLY 

GDPOLY 

HNPOLY 

HDPOLY 

OLNPOLY 

OLDPOLY 

CLNPOLY 

CLDPOLY 


ROOTA 

ROOTS 

ROOTC 

ROOTD 

GZERO 

GPOLE 

HZERO 

HPOLE 

OLZERO 

OLPOLE 

CLZERO 

CL POLE 


AMAT 

BMAT 

CHAT 

DMAT 

KMAT 

FMAT 

GMAT 


GTF 

HTF 

OLTF 

CLTF 


POLYNOMIAL  DEFINITIONS 

Coefficients  of  polynomial  A 
Coefficients  of  polynomial  B 
Coefficients  of  polynomial  C 
Coefficients  of  polynomial  D 
GTF  numerator  polynomial  coefficients 
GTF  denominator  polynomial  coef f ici'^nts 
HTF  numerator  polynomial  coefficients 
HTF  denominator  polynomial  coefficients 
OLTF  numerator  polynomial  coefficients 
OLTF  denominator  polynomial  coefficients 
CLTF  numerator  polynomial  coefficients 
CLTF  denominator  polynomial  coefficients 

ROOT  ARRAY  DEFINITIONS 

Roots  of  POLYA 

Roots  of  POLYB 

Roots  of  POLYC 

Roots  of  POLYD 

GTF  zeros  = roots  of  GNPOLY 

GTF  poles  = roots  of  GDPOLY 

HTF  zeros  = roots  of  HNPOLY 

HTF  poles  = roots  of  HDPOLY 

OLTF  zeros  = roots  of  OLNPOLY 

OLTF  poles  = roots  of  OLDPOLY 

CLTF  zeros  = roots  of  CLNPOLY 

CLTF  poles  = roots  of  CLDPOLY 

MATRIX  DEFINITIONS 


Continuous  System  Matrix 

Continuous  Input  Distribution  Matrix 

Output  Matrix 

Direct  Transmission  Matrix 

State-variable  Feedback  Matrix 

Discrete  System  Matrix 

Discrete  Input  Distribution  Matrix 

TRANSFER  FUNCTION  DEFINITIONS 


. GNPOLY/GDPOLY 
« HNPOLY/HDPOLY 
. OLNPOLY/OLDPOLY 
. CLNPOLY /CLDPOLY 


(GNK*GZERO) /(GDK*GPOLE) 

( HNK*Ki  ERO ) / ( HDK*HPOL  E ) 
<OLNK*OLZERO) /(OLDK*OLPOLE) 
(CLNK*CLZERO) /(CLDK*CLPOLE) 
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SECTION  5.  TOTAL’S  SCIENTIFIC  CALCULATOR 

I TOTAL’S  calculator  uses  reverse  polish  notation  and 
Is  modeled  after  an  HP-45  hand  calculator.  It  has  a stack 
of  four  registers,  X,  Y,  Z.  and  T,  where  X Is  the  display 

or  working  register,  and  twenty  memory  registers.  The  user 

/ 

may  enter  CALCULATOR  mode  at  any  time  by  typing  a ”C”  and 
leaves  CALCULATOR  mode  the  same  way.  CALCULATOR  mode  Is 
designated  by  the  prompt  **,  and  the  user  may  obtain  a 
listing  of  calculator  keys  by  typing  "KEYS"  as  shown  below. 

♦♦  REVS 


POLL 

CHS 

LDG 

MEMORY 

EXC  HmNGE 

SIh 

RLDG 

STDPE 

CLX 

CDS 

PDLRP 

PECRLL 

CLEPP 

TRN 

PECTRNG 

LRSTX 

PECTPPDCPL 

HS I M 

FIX 

DTOP 

SQURPE 

RCDS 

SC  I 

RTOD 

SQPDDT 

RTRh 

LIST 

DEGREES 

■|TDX 

LN 

STRCR 

RRDIRMS 

PI 

EXP 

FRSTSTRCK 

KEYS 

The  meaning  of  these  keys  will  be  discussed  later  In 
this  section. 

To  enter  a number  Into  the  X register,  the  user  simply 
types  It.  Numbers  are  entered  automatically  when  followed 
by  a blank,  comma,  or  carriage  return.  Typing  any  of  the 
variable  names  listed  In  Section  4 automatically  enters  the 
variable’s  value  Into  the  X register.  (Typing  a complex 
variable  name  with  only  one  subscript  will  put  the  real  part 
Into  X and  the  imaginary  part  Into  Y. ) 

An  example  of  entering  the  numbers  1.0,  2.0,  3.0  and 
4.0  Is  shown  on  the  following  page! 
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♦♦1234  STfiCK 


0. 000000 


1.000000 
2.  000  0 0 0 

3. 000000 

4. 000000 


The  1 ts  Initially  entered  into  the  X register  until  It 
Is  pushed  up  Into  Y by  the  2.  Subsequently,  the  3 pushes  the 
2 and  1 up  another  notch.  Finally,  the  4 Is  entered  leaving 
the  contents  of  the  four  stack  registers  as  shown  by  the 
STACK  command. 

Once  numbers  have  been  entered,  all  operations  occur 
between  X and  Y.  For  example,  typing  a would  add  X to  Y 
and  leave  the  sum  In  X.  The  contents  of  Z then  drop  Into  Y and 
T drops  li.to  Z.  The  contents  of  register  T are  unaffected. 
Similar  results  are  obtained  by  typing  or  where 

"/"  divides  Y by  X and  subtracts  X from  Y. 

One  final  example  should  clarify  stack  operation.  If  the 
user  wants  to  evaluate 

(3.14  * 2.78  ♦ 8.62  * 98.6)/6.02 
he  would  type 

**  3.14  2.78  * 8.62  98.6  * » 6.02  / 

and  TOTAL  would  print  out  the  answer.  What  actually  occurs  In 
Che  stack  is  thisi 

1.  3*14  is  entered  Into  X. 

2.  2.78  Is  entered  Into  X shoving  3.14  Into  Y. 

3.  X and  Y are  multiplied  leaving  8.73  In  X. 

4.  8.62  is  entered  Into  X shoving  8.73  Into  Y. 

5.  98.6  Is  entered  shoving  8.62  Into  Y and  8.73  Into  Z. 

6.  X and  Y are  multiplied  leaving  349.93  in  X and  dropping 
8.73  back  Into  Y. 
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7.  X and  Y are  added  leaving  858.66  in  X. 

8.  6.02  is  entered  into  X shoving  858.66  into  Y. 

9.  Y is  divided  by  X leaving  142.63  in  X. 

10.  TOTAL  prints  out  the  contents  of  the  X register  as 
the  answer. 

For  further  information  on  stack  operations  the  user  is 
referred  to  someone  who  owns  a Hewlett-Packard  calculator. 

All  that  remains  now  is  to  define  the  meaning  of  each  key. 
In  the  descriptions  below^'*old"  refers  to  status  before  the  key 
Is  executed  and  "new”  refers  to  status  afterwards.  Underlined 
letters  in  each  command  show  minimum  abbreviation  allowed. 


ROLL 

^CHANGE 

CLX 

CLEAR 

RECIPROCAL 

SQUARE 

SQROOT 

YTOX 


CHS 

SIN 

COS 

TAN 

hsm 

6SQS. 

ATAN 

U! 

LQ& 

EXP 

ALOG 

POLAR 


Moves  old  Y to  new  X,  old  Z to  new  Y,  old  T to 
new  Z and  old  X to  new  T 

Moves  old  X to  new  Y and  old  Y to  new  X 

Clear  X (sets  X to  0.0) 

Clear  stack  (sets  X,  Y,  Z,  and  T to  0.0) 

Sets  new  X equal  to  reciprocal  of  old  X 

Sets  new  X equal  to  old  X squared 

Sets  new  X equal  to  square  root  of  old  X 

Sets  new  X equal  to  old  Y to  the  old  X power  and 
move  old  Z into  new  Y and  old  T into  new  Z. 

Enters  3.14159265358979  into  new  X.  old  X into 
new  Y,  old  Y into  new  Z and  old  Z into  new  T. 

Change  sign  of  X 

Sets  new  X equal  to  sin(old  X) 

Sets  new  X equal  to  cos (old  X) 

Sets  new  X equal  to  tan(old  X) 

Sets  new  X equal  to  arcs in( old  X) 

Sets  new  X equal  to  arccos(old  X) 

Sets  new  X equal  to  arctan(old  X) 

Sets  new  X equal  to  natural  log(old  X) 

Sets  new  X equal  to  common  log(old  X) 

Sets  new  X equal  to  exp(old  X) 

Sets  new  X equal  to  10^°^*^ 

Converts  X and  Y In  rectangular  coordinates  to 
polart  where  X is  the  magnitude  and  Y is  the  angle 
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RECTANG 

FIX 

SCI 

LIST 

STACK 

FASTSTACK 

MEMORY 

STORE 

RECALL 


RADIANS 

KEYS 


Converts  X magnitude  and  Y angle  to  X and  Y 
rectangular  coordinates 

FIX  followed  by  any  number  from  0 to  14  sets 
all  future  calculator  outputs  to  that  many 
decimal  places 

Similar  to  FIX  except  that  numbers  are  thereafter 
expressed  in  scientific  notation  with  the 
specified  number  of  decimal  places 

Prints  contents  of  X register.  Useful  for 
displaying  intermediate  results  in  a long  string 
of  calculator  commands 

Prints  contents  of  X,  Y,  Z,  and  T vertically  \ 

Prints  contents  of  X,  Y,  Z,  and  T horizontally 

Prints  contents  of  all  20  memory  registers 

Must  be  followed  by  a number  from  1 to  20.  Stores 
contents  of  X to  specified  memory  register 

Must  be  followed  by  a number  from  1 to  20.  Recalls 
the  contents  of  specified  memory  register  to  X 
and  shoves  old  X to  new  Y,  old  Y to  new  Z and  old 
Z to  new  T 

Another  abbreviation  for  RECALL 

Recalls  the  value  of  X prior  to  the  last  operation 

Converts  old  X in  degrees  to  new  X in  radians 

Converts  old  X in  radians  to  new  X in  degrees 

Puts  calculator  into  degree  mode  and  turns  the 
switch  DEGREE  oh 

Puts  calculator  into  radian  mode  and  turns  the 
switch  DEGREE  off 


Types  out  a list  of  all  calculator  keys 
The  user  may  use  the  calculator  at  any  time  --  even  in 
the  middle  of  an  option  during  input  of  data.  For  further 
Information  see  Section  1.1. 
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SUMMARY  OF  TOTAL’S  OPTIONS 


COMMAND-  ATTACH. TOTAL. I D=AF IT 
COMMAND-  TOTAL 

WELCOME  TO  TOTAL- -TYPE  HELP  FOR  INTRO- -TYPE  STOP  TO  STOP 
OPTION  > HELP 


TOTAL  IS  AN  INTERACTIVE  COMPUTER-AIDED  DESIGN  PROGRAM 
FOR  DIGITAL  & CONTINUOUS  CONTROL  SYSTEM  ANALYSIS. 

IT  CONTAINS  100  OPTIONS  DIVIDED  INTO  GROUPS  OF  10 
ACCORDING  TO  GENERAL  APPLICATION. 

OPTIONS  ENDING  IN  0 LIST  THE  NEJCT  10  OPTIONS, 

FOR  EXAMPLE,  OPTION  30  LISTS  OPTIONS  30  THRU  39. 


THE  FOLLOWING  ARE  THE  MAIN  OPTION  GROUPS: 

0-9:  TRANSFER  FUNCTION  INPUT  OPTIONS 
10-19:  MATRIX  INPUT  OPTIONS 
20-29:  BLOCK  DIAGRAM  MANIPUUXTION  OPTIONS 
30-39:  TIME  RESPONSE  OPTIONS 
40-49:  ROOT  LOCUS  OPTIONS 
50-59:  FREQUENCY  RESPONSE  OPTIONS 
60-69:  POLYNOMIAL  OPTIONS 
70-79:  MATRIX  OPERATIONS 
80-89:  DIGITIZATION  OPTIONS 
90-99:  MISCELLANEOUS  OPTIONS 

WHEN  INPUT  IS  REQUESTED  BY  TOTAL,  THE  USER  MAY: 

ENTER  THE  REQUESTED  INFORMATION,  OR: 

TYPE  ? FOR  EXPLANATION  OF  INPUT  NEEDED, 

TYPE  L FOR  A LIST  OF  CURRENT  VARIABLE  VALUES, 
TYPE  * TO  LEAVE  AN  ITEM  UNCHANGED, 

TYPE  C TO  USE  CALCULATOR  BEFORE  OR  DURING  INPUT, 
TYPE  $ TO  ABORT  THE  OPTION, 

TYPE  X OR  Y,  Z,  T,  OR  R1  THRU  R20  TO  TELL  TOTAL 
TO  GET  REQUESTED  INFO  FROM  CORRESPONDING 
CALCULATOR  REGISTER. 


TO  END  TOTAL,  TYPE  STOP. 
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TRANSFER  FUNCTION  INPUT  OPTIONS 

* 0 LIST  OPTIONS 

* 1-  RECOVER  ALL  DATA  FROM  FILE  MEMORY 

* 2 POLYNOMIAL  FORM--GTF 

* 3 POLYNOMIAL  FORM--HTF 

* 4 POLYNOMIAL  FORM--OLTF 

* 5 POLYNOMIAL  FORM--CLTF 

* 6 FACTORED  FORM GTF 

* 7 FACTORED  FORM HTF 

* 8 FACTORED  FORM OLTF 

* 9 FACTORED  FORM CLTF 

MATRIX  INPUT  OPTIONS 
*10  LIST  OPTIONS 

*11  A MAT --CONTINUOUS  SYSTEM  MATRIX 

* 12  BMAT- -CONTINUOUS  INPUT  MATRIX 

*13  CMAT- -OUTPUT  MATRIX 

* 14  DMAT- -DIRECT  TR^\NSMISSION  MATRIX 

*15  KMAT- -STATE  VARIABLE  FEEDBACK  MATRIX 
*16  FMAT- -DISCRETE  SYSTEM  MATRIX 

*17  GMAT- -DISCRETE  INPUT  MATRIX 

* 18  SET  UP  STATE  SPACE  MODEL  OF  SYSTEM 

*19  EXPLAIN  USE  OF  ABOVE  MATRICES 

BLOCK  DIAGRAM  MANIPULATION  AND  STATE  SPACE  OPTIONS 

* 20  LIST  OPTIONS 

* 21  FORM  OLTF  = GTF  * HTF  (IN  CASCADE) 

* 22  FORM  CLTF  » (GAIN*GTF)/  (1  ♦ GAIN*GTF*HTF) 

*23  FORM  CLTF  = (GAIN*OLTF) /(I  ♦ GAIN*OLTF) 

* 24  FORM  CLTF  « GTF  ♦ HTF  (IN  PARALLEL) 

* 25  GTF(s)  AND  HTF(s)  FROM  CONTINUOUS  STATE  SPACE  MODEL 

* 26  GTF(z)  AND  HTF(z)  FROM  DISCRETE  STATE  SPACE  MODEL 

* 27  WRITE  ADJOINT(sI  - AMAT)  TO  FILE  ANSWER 

*'28  FIND  HTF  FROM  CLTF  & GTF  FOR  CLTF  * GTF*HrF/(l ♦GTF*HrF) 

* 29  FIND  HTF  FROM  CLTF  & GTF  FOR  CLTF  « GTF  /(1+GTF*HTF) 

TIME  RESPONSE  OPTIONS 

* 30  LIST  OPTIONS 

* 31  TABULAR  LISTING  OF  F(t)  OR  F(k) 

* 32  PLOT  F(t)  OR  F(k)  AT  USER’S  TERMINAL 

* 33  PRINTER  PLOT  (WRITTEN  TO  FILE  ANSWER) 

* 34  CALCOMP  PLOT  (WRITTEN  TO  FILE  PLOT  ) 

* 35  PRINT  TIME  OR  DIFFERENCE  EQUATION  (F(t)  OR  F(k)) 

* 36  PARTIAL  FRACTION  EXPANSION  OF  CLTF  (OR  OLTF) 

* 37  LIST  T-PEA>K,  T-RISE,  T-SETL,  T-DUP,  M-PEAK,  FINAL  VALUE 

* 38  QUICK  SKETCH  AT  USER’S  TERMINAL 

* 39  SELECT  INPUT i STEP.  RAMP,  PULSE,  IMPULSE,  SINE 
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ROOT  LOCUS  OPTIONS  | 

* 40  LIST  OPTIONS  , 

* 41  GENERAL  ROOT  LOCUS  ^ 

* 42  ROOT  LOCUS  WITH  A GAIN  OF  INTEREST  ' 

* 43  ROOT  LOCUS  WITH  A ZETA  (DAMPING)  OF  INTEREST 

* 44  LIST  N POINTS  ON  A BRANCH  OF  INTEREST 

* 45  LIST  ALL  POINTS  ON  A BRANCH  OF  INTEREST 

* 46  LIST  LOCUS  ROOTS  AT  A GAIN  OF  INTEREST 

* 47  LIST  LOCUS  ROOTS  AT  A ZETA  OF  INTEREST  ' i 

* 48  PLOT  ROOT  LOCUS  AT  USER’S  TERMINAL 

* 49  LIST  CURRENT  VALUES  OF  ALL  ROOT  LOCUS  VARIABLES  ’ | 

FREQUENCY  RESPONSE  OPTIONS 

* 50  LIST  OPTIONS 

* 51  TABULAR  LISTING 

* 52  TWO  CYCLE  SCAN  OF  MAGNITUDE 

*53  TWO  CYCLE  SCAN  OF  PHASE 

* 54  PLOT  F(w)  AT  USER’S  TERMINAL 

* 55  CALCOMP  PLOT- -LINEAR  FREQUENCY  AXIS 

* 56  CALCOMP  PLOT- -LOG  FREQUENCY  AXIS 

* 57  TABULATE  POINTS  OF  INTEREST!  PEAKS,  BREAKS,  ETC.  i 

* 58  CALCOMP  PLOT--NYQUIST  POLAR  PLOT  1 

* 59  CALCOMP  PLOT- -NICHOLS  LOG-MAG/ANGLE  PLOT  I 


POLYNOMIAL  OPERATIONS 


* 60 

LIST  OPTIONS 

* 61 

FACTOR  POLYNOMIAL 

(POLYA) 

i 

1 

* 62 

ADD  POLYNOMIALS 

(POLYC  = POLYA  ♦ POLYB) 

1 

* 63 

SUB  POLYNOMIALS 

(POLYC  = POLYA  - POLYB) 

* 64 

MULTIPLY  POLYS 

(POLYC  = POLYA  * POLYB) 

* 65 

DIVIDE  POLYS 

(POLYC  ♦ REM  = POLYA  / POLYB) 

* 66 

STORE  POLY  INTO 

POLYD 

* 67 

EXPAND  ROOTs  into 

A POLYNOMIAL 

1 

* 68 

(s  ♦ a)**n  EXPANSION  INTO  A POLYNOMIAL 

* 69 

ACTIVATE  POLYNOMIAL  CALCULATOR 

MATRIX  OPERATIONS 

* 70  LIST  OPTIONS 

* 71  ROOTA  » EIGENVALUES  OF  AMAT 

* 72  CMAT  = AMAT  ♦ BMAT 

* 73  CMAT  « AMAT  - BMAT 

* 74  CMAT  ■ AMAT  * BMAT 

* 75  CMAT  » AMAT  INVERSE 

* 76  CMAT  » AMAT  TRANSPOSED 

* 77  CMAT  ■ IDENITY  MATRIX 

* 78  DMAT  ■ ZERO  MATRIX 

* 79  COPY  ONE  MATRIX  TO  ANOTHER 


f ^ 
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DIGITIZATION  OPTIONS  | 

* 80  list  options 

* 81  CLTF(s)  TO  CLTF(z)  BY  IMPULSE  INVARIANCE  ! h 

* 82  CLTF<s)  TO  CLTF(z)  BY  FIRST  DIFFERENCE  APPROXIMATION  j 

* 83  CLTF(s)  TO  CLTF(z)  BY  TUSTIN  TRANS FORI-iAT ION 

* 84  CLTF(z)  TO  CLTF(s)  BY  IMPULSE  INVARIANCE 

* 85  CLTF(z)  TO  CLTF(s)  BY  INVERSE  FIRST  DIFFERENCE 

* 86  CLTF(z)  TO  CLTF(s)  BY  INVERSE  TUSTIN 

* 87  FIND  FM/\T  AND  GMAT  FROM  AMAT  AND  BMAT  ! 

* 88  COMPUTE  FMAT  » exp(AMAT  * T)  ‘ [ 

* 89  CLTF(X)  TO  CLTF(Y)  BY  X = ALPHA*(Y  ♦ A)/(Y  ♦ B)  | 

I 

MISCELLANEOUS  OPTIONS  1 

LIST  OPTIONS  '■ 

UPDATE  MEMORY  FILE  WITH  CURRENT  D.\TA 

I 

LIST  CURRENT  SWITCH  SETTINGS  (ECHO,  ANSWER,  ETC)  I 


LIST  SPECIAL  COMMANDS  ALLOWED  IN  OPTION  MODE 
LIST  VARIABLE  NAME  DIRECTORY 
LIST  MAIN  OPTIONS  OF  TOTAL 
GIVE  THE  INTRODUCTION  TO  TOTAL 
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Appendix  B 

( SECTION  1.  INTRODUCTION 


This  manual  is  written  to  provide  documentation  on  all 
programs  and  subprograms  used  in  TOTAL  as  well  as  a description 
of  the  overall  structure  and  internal  operation  of  the  program. 
It  is  intended  for  the  Individual  who  wishes  to  make  his  own 
modification  and  additions  to  the  coding  and  as  a general 
aid  in  maintaining  the  program  or  transporting  it  from  one 
computer  system  to  another. 

The  reader  is  assumed  to  be  thoroughly  familiar  with  the 


SECTION  2.  DESCRIPTION  OF  OVERALL  STRUCTURE 


( 

TOTAL  Is  a large  program.  In  Its  absolute  form,  with 
all  external  references  satisfied,  It  requires  In  eccess  of 
600,000g  words  of  central  memory  for  execution.  Since  many 
computer  systems  do  not  have  this  much  memory  available,  and 
most  limit  Interactive  users  to  a much  smaller  amount  (on  the 
order  of  60K) , TOTAL  has  been  designed  with  a structure  of 
overlays  so  as  to  not  require  more  than  60K  at  any  one  time. 
The  following  Is  a brief  description  of  that  structurei 
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2.1  HOW  OVERLAYS  WORK 

Overlays  are  simply  a way  of  dividing  a large  program 
Into  a series  of  smaller  programs,  each  of  which  will  fit 
Into  the  available  amount  of  core  memory.  As  each  of  these 
programs  (overlays)  Is  needed.  It  Is  loaded  Into  memory 
replacing  one  which  has  Just  finished  executing.  A small 
executive  routine,  written  to  control  the  overall  flow  of  the 
program.  Is  responsible  for  calling  each  overlay  Into  memory 
as  It  Is  needed.  This  executive  Is  called  the  main  overlay 
and  remains  In  core  memory  at  all  times.  The  program  segments 
which  It  controls  are  called  primary  overlays.  Only  one 
primary  overlay  may  be  In  central  memory  with  the  main  overlay 
at  a time.  It  Is  also  possible  to  have  another  level  of 
overlays  which  can  be  called  by  a given  primary  overlay. 

These  programs  are  called  secondary  overlays. 

Each  overlay  Is  a separate  program  %dilch  Is  loaded  Into 
memory  and  executed  when  It  Is  called  by  a higher  level  overlay. 
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Information  Is  passed  between  overlays  through  labeled 
common  statements  in  the  main  overlay. 

The  use  of  overlays  should  become  more  apparent  when 
their  use  In  TOTAL  Is  described  In  the  next  section.  For 
further  Information,  the  reader  Is  referred  to  the  CPC  FORTRAN 
Reference  Manual  and  the  CPC  Loader  Reference  Manual. 

2.2  TOTAL'S  OVERLAY  STRUCTURE 

TOTAL  In  Its  present  form  uses  one  main  overlay,  seventeei^ 
primary  overlays,  and  eleven  secondary  overlays. 

The  main  overlay  simply  holds  the  common  data  arrays, 
establishes  their  default  values,  and  calls  each  of  the  primary 
overlays  when  needed,  as  determined  by  a short  dec Is Ion -making 
routine.  This  overlay  Is  described  In  detail  In  Section  3. 

The  primary  overlays  perform  all  of  the  actual  operations 
In  TOTAL.  Each  Is  responsible  for  a certain  class  of  functions 
which  may  Include  option  and  command  execution,  variable 
definition  and  modification,  switch  setting,  user  assistance, 
and  Interactive  user  Interfacing.  If  an  overlay  Is  too  large 
for  the  given  core  restriction.  It  Is  divided  Into  secondary 
overlays  that  will  fit.  Primary  and  secondary  overlays  are 
discussed  In  detail  In  Section  4. 

Each  overlay  program  Is  allowed  any  number  of  subprograms, 
each  of  which  takes  up  some  of  the  memory  space  allowed  for 
that  overlay.  These  subroutines,  are  described  In  depth  In 
Section  5. 
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SECTION  3.  DESCRIPTION  OF  MAIN  EXECUTIVE  OVERLAY 

TOTAL'S  main  executive  overlay  performs  four  functions 
vital  to  program  operation.  First,  It  houses  In  its  PROGRAM 
statement  the  definition  of  all  Input-output  devices  throughout 
the  program.  Second,  It  contains  all  of  the  labeled  common 
statements  for  the  data  base  (variables  which  are  used  by 
more  than  one  program  and  which  must  remain  In  central  memory 
at  all  times).  Third,  It  Initializes  the  values  of  all  the 
variables  In  the  common  data  base.  Finally,  It  contains  the 
routine  which  selects  other  overlays  and  controls  the  flow  of 
the  entire  program.  Since  a thorough  understanding  of  this 
overlay  Is  essential  to  further  modifications  and  additions, 
the  remainder  of  this  section  Is  devoted  to  a complete  description 
of  Its  structure. 
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3.1  THE  PROGRAM  STATEMENT 

The  program  statement  for  TOTAL  Is  shown  below. 


PROGRAM  TOTAL  < INPUT= 1 OOB  r OUTPUT  = 1 OOB » AKE Y= 1 OOB  r BKE Y=1 OOB , 
+CKEY=100B » ANSUER , MEMORY » DOODLE= 1 OOB » PLOT » TAPEl =AKEY » 
+TAPE2=BKEY  r TAPE3=CKEY » TAPE5=INPUT » TAPE6=ANSWER » 

+TAPE7=0UTPUT » MEMAUX=1000B  f TAPE8=MEMAUX  f TAPE9=MEM0RY  f 
+TAPE10=D00DLE) 

It  performs  three  functions.  Including  definition  of 
local  file  name,  reference  number,  and  buffer  length  for  each 
I/O  device  (tape)  used  by  TOTAL.  The  name  and  purpose  of 
each  of  these  tapes  Is  given  In  Table  I . 

The  choice  of  buffer  size  for  each  of  these  tapes  Is  a 
trade-off  between  amount  of  memory  used  and  speed  of  execution. 
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A buffer  Is  just  a location  In  central  memory  where  output  Is 
placed  until  It  can  be  written  to  a tape  by  an  output  device. 
Since  output  is  usually  generated  much  faster  than  it  can  be 
written  to  tape,  the  buffer  often  fills  up  and  execution  must 
be  interrupted  until  the  output  device  can  catch  up.  This 
slows  down  execution  time.  By  increasing  the  buffer  size, 
fewer  Interruptions  are  needed  and  the  program  runs  faster  at 
the  expense  of  space  in  central  memory.  Since  space  in  a 
program  of  this  size  is  at  a premium,  buffer  size  must  be 
kept  at  the  minimum  value  consistant  with  reasonably  fast 
operation. 

The  rule  of  thumb  used  in  selecting  buffer  sizes  in 
TOTAL  was  that  frequently  used  files  which  receive  output  in 
large  volumes  are  given  large  buffers  (lOOOB  to  2000B)  while 
all  others  are  kept  at  the  minimum  size  of  lOOB  = lOOg  * ^^10 
words  of  central  memory.  Even  with  this  careful  assignment, 
7600g  words  of  central  memory  out  of  the  allowed  60,000g  are 
devoted  to  buffer  use  in  TOTAL.  Should  more  space  ever  be 
needed  for  any  reason,  reducing  this  buffer  size,  at  the 
expense  of  execution  time,  is  a possible  solution. 

3.2  TOTAL’S  COMMON  DATA  BASE 

Figure  1 shows  the  labeled  common  statements  which  make 
up  TOTAL’S  data  base.  Every  variable  which  must  be  passed 
from  overlay  to  overlay  or  which  is  needed  throughout  the 
program  for  any  reason  must  be  placed  in  this  array.  Numbers 
not  located  in  common  are  lost  each  time  a new  overlay  replaces 
an  old  one. 
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C0MM0N/T0TALl/AMAT(10»10)»NA»MA»BMAT<10f 10) fNBfMB»ChAT(10»10)» 
+NCfHCfDMAT(10»10) >ND»MD»FMAT( lOflO) »NF»MFfGMAT(10r 10) fNGfMGr 
+AKMAT(10f 10) »NK»MK 

C0MM0N/T0TAL7/P0L YA  < 51 ) f POL YB ( 51 ) f POL YC ( 51 ) f POL YD ( 51 ) » 
+R00TA(50»2) »R00TB(50f2) fR00TC(5O»2) rR00TD<50f2) » 

+NPA » NPB  F NPC  F NPD  f PAK  f PBK  f PCK  f PDK 
C0MM0N/T0TAL9/GNP0LY<51 ) fGDP0LY(51 ) fGZER0(50f2) fGPOLE(50f2) f 
+NGZ  F NGP  F 6K  F 6NK  f GDK 

COMMON/TOTL 1 0/HNPOL Y < 51 ) f HDPOLY ( 51 ) f HZERO  < 50  f 2 ) f HPOLE ( 50  f 2 ) f 
+NHZ  F NHP  F HK  F HNK , HDK 

COMMON/TOTL11/OLNPOLY<51) f0LDP0LY(51) f0LZER0<50f2) f0LP0LE(50f2) F 
+NOLZ  F NOLP  F OLK  f OLNK  f OLDK 

C0MM0N/T0TL12/CLNP0LY(51 ) FCLriP0LY(51 ) fCLZER0(50f2) fCLP0LE(50f2) f 
+NCLZ  F NCLP  F CLK  f CLNK  f CLDK 

COMMON/TOTL 1 4/NOPT  f I OPT  f JOPT  f KOPT  f LOPT  f MOPT  f LPROMT  f LASTOPT  f NGO 
COMMON/TOTL15/IFLAG(100) F JFLAGCIOO) fKFLAG(20) fLFLAG<20) fNCALL(20) 
COMMON/TOTL 1 6/X  f Y f Z f T f REG ( 20 ) f XLAST 
C0MM0N/T0TL17/MC0MM(100) fDATMC 100) fMPT 
COMMON/TOTL18/NRPTfNROUTE(10) fNPT 
C0MM0N/PARTL1/ZZZ(50) fXRfNXXf YYY(50) fW<50) fCLOSE 
C0MM0N/PARTL2/CR ( 50 ) f EC ( 50 ) f OM  < 50 ) f FE ( 50 ) f LL  f DAT I N ( 4 ) 
C0MM0N/PARTL4/FAX ( 2 ) f AXMIN  f FRANCE  f FTMAX  f FTM I N 
C0MM0N/PARTL5/RSL0PEfRWIDTHfRHIGHTfR0MEGAfINPUTR 
COMMON/ROOTLI/BOUNDfFPNfIFOLDfISTAMfITITLfITHESfRADfZETA 
C0MM0N/R00TL2/LLR00T f DELPR ( 50 ) f DEL  < 50 ) f GAIN f GTOL  f LN f IPLOT 
C0MM0N/R00TL3/XP(50) fYP(50) fXZ<50) fYZ<50) fNfMfXSTARTfYSTARTfTIME 
C0MM0N/R00TL4/GA  f AA  f BB  f CC  f DD  f JK 
COMMON/FREQR 1 / WM IN  f UMAX  f DELW  f YI N ( 3 ) f NUP  f NDOUN 
C0MM0N/FREQR2/KIND  f C YCLENG  f NC YC  f IPOW  f RANGE  f ORDER 
COMMON/FREQR3/AMINfAMAXfAXLIN(2) fAXDB(2) fFNMAXfFNMIN 
C0MM0N/DMULR/P0LYQ<51) fR00TQ(50f2) fNOfPOK 

C0MM0N/READER/LC0MfL0DVfL0DIfL1DVfLCPLXVfL2DVfLKEYfLABBRf 

+LASTFfLMAT 

COMMON/LOGIC 1 /REQUEST  f ECHO  f EXTCALC  f CALC  f EQUAL  f COMMA  f L 1ST 
C0MM0N/L0GIC2/CL0SED  f DEC I BEL  f HERTZ  f DEGREE  f ANSUER  f PL AT  f GRI D f SCALE 
C0MM0N/L0GIC3/TEST  f ALREADY 

COMMON/MATRIXl/AINdO)  fIRUNfNUfNYfNSfMUfLY 
COMMON/TTYPLT/OKf IPT 

common/ploter/mult  F jpLOT  f kplot  f lplot  f fact 

C0MM0N/X153/SCRTCH(153) 

COMMON/DIGIT/TSAMP  f SAMPT  f ALPHAT  f SIGMAA  f SIGMAB 
COMMON/MASSTO/ I NMASS ( 47 ) 

DIMENSION  R00TR(50)  fROOTKSO) 

LOGICAL  REQUEST f ECHO f EXTCALC f CALC f EQUAL f COMMA f LIST f 
-t-CLOSED  F DECIBEL  f HERTZ  f DEGREE  f ANSUER  f PLAT  f GRID  f SCALE 
LOGICAL  TEST F ALREADY fGOPLOT 


Fig.  1.  TOTAL'S  common  data  base. 
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Variables  In’ this  data  base  are  initialized  to  their 
default  values  at -.the  beginning  of  the  nvaln  executive  overlay. 

3.3  DESCRIPTION  OF  THE  H\IN  EXECUTIVE  OVERLAY 

The  discussion  In  this  section  Is  a detailed  description 
of  TOTAL'S  main  executive  overlay.  The  reader  Is  referred  to  ^ 

the  flow  chart  on  the  following  page  which  may  be  helpful  In 
reading  the  remainder  of  this  section.  i 

When  execution  of  TOTAL  begins,  all  variables  In  the 
common  data  base  are  initialized  as  described  In  Section  3.2. 

The  mass  storage  file  MEMAUX  Is  also  opened.  TOTAL  then  enters 
OPTION  mode  at  statement  11110  and  calls  program  RDIDER  (overlay 
6)  to  receive  a string  of  commands,  option  numbers,  etc.  from 
the  user.  READER  compiles  the  user's  Input,  stores  the  commands 
In  coded  form  In  the  array  MCOMM,  sets  the  MPT  pointer  to  the 
first  command  In  MCOMM  and  returns  control  to  the  executive 
overlay  at  statement  number  11111.  READER  Is  discussed  In 
much  greater  detail  In  Section  4. 

Statement  11111  Is  the  main  control  node  of  the  entire 
program.  Every  overlay  returns  control  to  this  point  when  It  i 

i 

has  finished  executing.  From  this  point,  program  flow  runs  | 

through  a three  level  sorter  to  determine  where  control  should  ! 

be  transfered  next.  These  levels  Include  the  Internal  routing 
controller,  the  command  type  sorter,  and  the  master  overlay 
selector. 

Internal  routing  controller. 

This  controller  Is  a special  utility  which  allows  one 
overlay  to  specify  a sequence  of  additional  overlays  to  be  called 
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before  TOTAL  moves  on  to  the  next  user  command.  Normally, 
when  the  user  gives  a command,  the  necessary  overlay  Is 
selected.  It  executes  the  command,  and  TOTAL  moves  on  to  the 
next  command.  If,  however,  for  some  reason  more  than  one 
overlay  is  needed  to  complete  the  given  command,  the  first 
overlay  called  sets  up  the  sequence  of  additional  overlay 
calls  that  will  be  needed  and  stores  them  in  the  array  NROUTE. 
TOTAL  then  executes  all  commands  in  NROUTE  before  moving  on  to 
the  next  main  command  in  the  MCOMM  array. 

A typical  example  of  this  procedure  is  in  the  execution 
of  option  48.  Overlay  4 contains  all  of  the  necessary  routines 
for  calculating  points  on  a root  locus.  It  does  not,  however, 
have  room  for  the  routine  which  actually  plots  the  points  and 
an  additional  overlay  (overlay  11)  is  needed.  Now,  when 
overlay  4 has  finished  computing  the  points,  it  stores  an  11 
in  NROUTE(l),  sets  the  NRPT  pointer  equal  to  1,  and  returns 
control  to  the  executive.  The  executive  sees  that  NRPT  is  not 
zero  and  uses  the  internal  routing  controller  to  send  control 
to  the  overlay  number  stored  in  NROUTE(NRPT)  * NROUTE(l)  » 11. 
NRPT  is  then  incremented  and  when  overlay  11  has  finished, 
control  is  transfered  to  overlay  number  NROUTE(NRPT)  * 

NR0UTE(2)  B 0.  Whenever  a zero  is  encountered  (as  in  this  case), 
TOTAL  knows  that  the  last  internal  command  has  been  complete. 
NRPT  is  set  back  to  zero  and  program  flow  passes  on  to  the 
coounand  type  sorter.  Since  NROUTE  has  a dimension  of  20,  up 
to  20  secondary  commands  can  be  specified  if  needed.  An 
overlay  can  even  have  itself  called  back  when  the  series  it 

specified  is  finished  by  simply  putting  its  own  overlay  number 
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into  the  NROUTE  array.  This  Is  how  temporary  Interrupts  to 
CALCULATOR  or  HELP  modes  are  handled. 

Command  type  sorter. 

This  routine  begins  at  statement  11113  as  shown  In  Fig.  2. 
The  command  type  sorter  Increments  the  MPT  pointer,  looks  at 
the  coded  command  stored  In  MCOMM(MPT),  and  decides  where  the 
program  flow  should  go  next.  If  the  next  Item  In  the  array 
Is  a general  command  or  variable  operation  (MCOMM(MPT)  = 

1,  2,  3,  4,  or  5),  program  DECODER  (overlay  7)  Is  called  to 
decode  and  execute  It.  If  MCOMM(MPT)  = 6,  the  next  command  Is 
an  option  number  and  control  Is  given  to  the  master  overlay 
selector.  The  COPY  command  has  an  entire  program  (overlay  15) 
devoted  to  It  and  so,  rather  than  calling  DECODER,  control  Is 
passed  to  overlay  15  directly.  MCOMM(MPT)  = 0 Indicates  that 
the  last  command  has  been  executed  and  the  executive  returns 
to  statement  11110  to  call  READER  and  ask  the  user  for  further 
Instructions . 

Master  overlay  selector. 

Since  each  of  TOTAL'S  options  may  be  located.  In  general, 
In  any  one  of  the  17  overlays,  a method  Is  needed  to  select 
the  correct  overlay  for  a given  option.  This  Is  done  with  a 
massive  GO  TO  statement  called  the  "master  overlay  selector." 

101  GO  T0(  If  3f  3f  3f  3f  3f  3f  3f  3f  9f 
+ 14f 14f 14f 14f 14f 14f 14f 14f  9f  9t 

+ 17f 17fl7fl7Fl4f 14f 14f 17f 17f  9f 

+ 2f  2f  2f  2f  2f  2f  2f  2f  2f  9f 

+ 4f  4f  4f  4f  4f  4f  4f  4f  4f  9f 

+ 5f  5f  5f  5f  5f  5f  9f  9f  9f  9f 

■f  3f  3f  3f  3f  3f  3f  3f  3f  3f  9f 

14fl4f  14f  14f  14f  14rl4f  14f  14f  9f 
4 16fl6f 16f 16f 16rl6f  9r  9fl6f  9f 

+ If  9f  13f  9f  18f  9f  9f  9r  9f  9) r NOPT 


'I 


} 1 
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Entries  in  this  computed  GO  TO  statement  are  Indexed 
^ by  the  option  number#  NOPT,  and  are  simply  the  statement 

numbers  for  the  corresponding  overlay  calling  statements. 

For  example,  If  NOPT  * 93,  control  Is  transferred  to  statement 
number  13  which  just  happens  to  be  the  C/\LL  statement  for 
overlay  13,  and  so  on. 

The  value  of  NOPT  Is  obtained  In  statement  88  from  an 
array  DATM(MPT)  which  Is  Indexed  by  the  same  pointer,  MPT,  as 
the  primary  command  array  MCOMM(MPT).  When  the  user  types  a 
valid  option  number,  the  fact  that  It  Is  an  option  number  Is 
stored  as  MCOMM(MPT)  = 6 and  Its  actual  value  stored  In 
DATM(MPT).  Complete  details  on  these  arrays  are  given  under 
program  READER  In  Section  4. 

Other  operations  performed  In  this  overlay. 

^ The  "CHECK  SUPPRESS"  block  In  the  flow  chart  Is  just  a 

look  ahead  operation  to  see  If  the  user  has  typed  an  "S" 
following  the  option  number.  If  the  suppress  code  ^ stored 
In  MC0MM(MPT  +1),  the  logical  variable  REQUEST  Is  set  to 
.FALSE,  to  tell  TOTAL  to  skip  requesting  any  Input  It  may  need 
to  execute  the  option  and  just  use  the  old  (or  default)  values. 
If  the  S code  Is  found,  MPT  Is  Incremented  so  that  the  SUPPRESS 
command  Itself  will  not  be  executed  the  next  time. 

If  the  plotter  has  not  been  Initialized  and  the  upcoming 
option  will  generate  a plot,  the  "INITIALIZE  PLOTTER"  block 
will  be  executed.  This  routine  ensures  that  the  plotter  Is 
initialized  once  and  only  once.  (Every  time  the  plotter  Is 
Initialized,  a new  banner  Is  drawn  on  the  PLOT  file.) 

When  the  block  labeled  OPENMS  Is  executed,  TOTAL  calls 
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the  subroutine  OPENMS  to  open  the  n»ass  storage  file  MEMAUX. 

( If  MEMAUX  does  not  contain  any  information  (from  previous 

runs  of  TOTAL),  this  routine  fills  all  45  storage  sections 
with  zeros.  If  these  arrays  were  not  defined  in  this  manner 
and  the  user  later  tried  to  read  from  a location  to  which  he 
had  not  first  written,  a fatal  error  would  occur  and  execution 
of  TOTAL  would  end  abruptly. 

After  any  overlay  has  finished  executing,  control  is  always 
returned  to  statement  11111  and  the  cycles  described  above  are 
repeated.  When  the  command  STOP  is  finally  typed,  DECODER  sets 
NOPT  = -1  and  when  statement  11113  is  executed,  overlay  1 is 
called  to  write  all  data  in  the  common  data  base  to  local  file 
MEMORY  and  stop  the  program. 


c 
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SECTION  4.  DESCRIPTION  OF  TOTAL'S  OVERLAYS 

( 

This  section  Is  intended  to  document  the  structure, 
purpose,  and  general  operation  of  each  of  TOTAL'S  primary 
overlays.  The  source  listings  of  each  of  these  programs 
include  liberal  use  of  comment  statements  which  are  intended 
to  make  them  self-explanatory  to  the  programmer.  This 
section  contains  additional  information  which  may  be  useful 
in  understanding  and  using  the  program  coding. 


( 
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4.1  OVERLAY  (1.0)  --  PROGRAM  UPDATP 

Program  UPDATE  is  one  of  TOTAL'S  smallest  overlays.  It 
performs  only  two  functions,  including  writing  information 
from  common  to  local  file  MEMORY  and  reading  that  information 
back  in. 

When  option  91  is  selected,  UPDATE  is  called  by  the  main 
executive  overlay.  Local  file  MEMORY  (TAPE9)  is  rewound  and 
all  variables  in  the  common  data  base  are  written  onto  it. 

The  first  number  written  is  the  code  number  "989"  used  to 
Identify  the  tape  as  a MEMORY  file.  After  all  information  has 
been  saved  with  a series  of  simple  WRITE  statements,  control 
is  returned  to  the  main  overlay. 

The  reverse  sequence  of  events  takes  place  when  UPDATE 
executes  option  1 . MEMORY  is  rewound  and  tested  to  see  if  its 
first  entry  is  "989".  If  it  is  not,  an  error  message  is 
printed,  otherwise,  the  data  is  read  back  into  the  common  data 
base  and  the  option  terminates  as  before. 

When  the  command  STOP  is  executed,  UPDATE  does  option  91 , 
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returns  unneeded  local  files,  and  terminates  TOTAL 


( 


4.2  OVERLAY  (2.0)  --  PROGEUM  TIMER 

Overlay  (2,0)  is  just  a short  executive  overlay  which 
calls  three  secondary  overlays  as  needed  to  perform  digital 
and  continuous  time  response  options.  For  continuous  responses 
(TSAMP  = 0)  or  partial  fraction  expansions  (NOPT  = 36),  It 
calls  program  PARTL  (Overlay  (2,1)).  For  discrete  responses 
(TSAMP  4 0)  or  selecting  Inputs  (NOPT  = 39),  DIGITR  (Overlay 
(2,2))  Is  called.  If  a Calcomp  plot  Is  generated  (NOPT  = 34), 
PLOTFIN  (overlay  (2,3))  Is  called  to  finish  drawing  the  titles, 
axes,  etc.  Sections  4.3,  4.4,  and  4.5  describe  these  three 
secondary  overlays. 

4.3  OVERLAY  (2.1)  --  PROGRAM  PARTL 

Program  PARTL  uses  a Heaviside  partial  fraction  expansion 
algorithm  taken  from  the  AFIT  program  of  the  same  name.  (Ref.l 
Most  other  features,  however.  Including  plots,  listings,  and 
function  outputs,  are  new  and  greatly  Improved.  Fig.  3 
provides  a general  flow  chart  of  the  program.  The  blocks 
labeled  "standard  Interrupt  routine"  and  "restart"  are  used 
to  allow  temporary  Interruptions  of  the  program  to  call  the 
CALCULATOR  and  HELP  overlays.  The  value  of  NCALL(4)  set  and 
used  by  these  routines  simply  allows  program  flow  to  find  Its 
»#ay  back  to  the  statement  at  which  the  Interruption  occurred. 

A complete  explanation  of  these  routines  Is  given  In  Section  5 
under  subroutine  READS. 

At  the  beginning  of  PARTL,  the  transfer  function  of  interest 
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is  loaded,  multiolied  by  the  transform  of  the  Input  of 
Interest,  and  tested  for  legal  form.  A partial  fraction 
expansion  (PFE)  is  then  performed  and  the  desired  time 
function  determined  from  an  inverse  Laplace  transformation 
of  the  PFE  terms.  Options  35  and  36  print  out  some  of  the 
results  of  these  computations  while  thay  are  being  obtained. 
All  other  options  use  the  general  function  subprogram  FT(T) 
to  obtain  the  actual  time  response  results.  FT(T)  gets  its 
information  through  labeled  common  statements  and  is  described 
more  fully  in  Section  5. 


4.4  OVERLAY  (2.2)  --  PROGRAM  DIGITR. 

Given  an  n^^  order  transfer  function  such  as 

c(2)  ^ 

^ b^ 

DIGITR  calculates  a discrete  time  response  by  forming  the 
recursive  difference  equation 

c(k)  = a^rCk)  + a2r(k  - 1)  + a^rCk  - 2)  - b2c(k  - 1)  - b^cCk  - 2) 
and  iterating  it  for  some  desired  input  sequence. 

Subroutine  RIN  is  used  to  supply  the  input  sequence 
(ramp,  step,  pulse,  etc.)  and  subroutine  PROGAT  shifts  the 
arrays  of  past  inputs  and  outputs  and  evaluates  c(k)  for  each 
new  value  of  k. 

After  the  response  values  are  calculated  over  the  range  of 
k specified,  DIGITR  plots  and/or  tabulates  the  results  in  much 
the  same  way  as  PARTL.  A flow  chart  for  DIGITR  is  shown  i" 


Fig.  4. 
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4.5  OVERLAY  (2.3^  --  PROGRAM  PLOTFIN.  | 

I 

This  program  finishes  up  the  Calcomp  plots  for  PARTL 
and  DIGITR.  Both  programs  are  responsible  for  drawing  their  ) 

own  actual  response  curves,  but  PLOTFIN  does  Che  rest  • ' 

Including  boxes,  grids,  title,  time  axis,  and  tic  marks.  The 
actual  coding  itself  Is  very  straightforward  and  needs  little 

explanation.  L 

i 

) I 

4.6  OVERLAY  (3.0)  --  PROGRAM  POLY. 

POLY  handles  all  transfer  function  Input  and  polynomial  j 

operations  for  TOTAL.  It  Is  responsible  for  17  options,  | 

Including  options  2 through  9 and  61  through  69,  making  It  : 

one  of  the  largest  overlays  in  the  program.  Its  structure, 
however.  Is  very  simple. 

POLY  Is  divided  Into  17  sections  which  are  addressed  by 
branches  of  computed  GO  TO  statements.  For  a given  option 
number,  only  one  of  these  sections  is  executed  before  control 
Is  returned  to  the  main  overlay.  Thus,  each  section  Is  i 

essentially  Independent  of  the  others  and  It  Is  not  difficult 
to  understand  the  operation "of  any  particular  option.  j 

The  understandablllty  of  POLY  is  further  enhanced  by  | 

extensive  use  of  subroutines  In  its  design.  This  modular  || 

approach  allows  a person  to  study  the  program  "from  the  top 
down"  by  treating  lower-level  routines  as  "black  boxes" 
while  studying  those  at  a current  level.  Subroutines  used  In 
POLY  are  discussed  In  detail  In  Section  5. 

POLY  does  have  one  unique  feature  that  Is  worthy  of 
mention!  the  use  of  an  Interrupt  request  to  factor  polynomials. 
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Because  of  the  program's  size  and  the  large  number  of  subroutines  ' 

It  uses,  there  was  not  enough  room  for  everything  in  a single  | 

overlay.  Therefore,  the  factoring  subroutine  DMULR  was  moved 

to  a separate  overlay  (overlay  10)  to  make  room  for  the  rest.  ■ 

I 

With  this  approach,  when  polynomial  roots  are  needed, 

POLY  terminates  temporarily,  overlay  10  is  executed,  and 
POLY  is  restarv;ed,  beginning  execution  where  it  leit  off.  The 
polynomial  to  be  factored  and  its  resulting  roots  are  passed  j ] 

between  the  two  overlays  with  a labeled  common  statement.  j 

The  procedure  described  above  is  called  the  "standard 
interrupt  routine."  It  is  initiated  by  a series  of  FORTFtXN 
statements  such  as  those  found  beginning  at  statement  8002  in 
POLYi 

I 

NRPT-1  , Tell  the  executive  (overlay(0, 0)) that  this  is 

an  Interrupt  request,  not  a normal  termination. 

NROUTE(1)=10  Tell  the  executive  that  this  is  an  interrupt 
request  for  overlay  10. 

NROUTE(2)=3  Tell  the  executive  to  return  control  to  overlay 
3 (POLY)  when  overlay  10  has  finished. 

I 

NCALL(1)=12  Tell  the  RESTART  routine  at  the  beginning  of  ' 

POLY  to  jump  to  the  12th  statement  number  in 
its  GO  TO  array  when  POLY  is  restarted  (so 
that  POLY  will  pick  up  at  statement  8003  where  . 
it  left  off). 

GO  TO  loco  Send  control  to  the  executive  so  that  it  can  i 

begin  the  above  set  of  Instructions.  ' 

The  net  effect  of  this  interrupt  routine  is  that  it  i 

allows  one  primary  overlay  to  call  another  --a  feat  not  * 

normally  possible  with  overlays.  Further  Information  on  this 

\ 

technique  is  presented  in  the  discussion  of  subroutine  READS  j 

In  Section  5. 

1 
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4.7  OVERLAY  (4.0)  --  PROGRAM  ROOTIO. 


ROOTIO  is  the  executive  primary  overlay  which  controls,,., 
the  four  secondary  overlays  that  do  all  the  root  locus 
options  In  TOTAL.  It  Is  essentially  the  original  AFIT 
program  ROOTL,  (Ref.  2 ) although  It  has  been  modified  and 
Improved  considerably. 

A general  flow  diagram  for  ROOTIO  Is  given  In  Fig.  5. 

The  secondary  overlays  it  calls  are  described  in  the  following 
sections. 


4.8  OVERLAY  (4.1)  --  PROGRAM  ROOTll. 

ROOTll  sets  up  the  Calcomp  plot.  It  Is  responsible  for 
drawing  everything  but  the  actual  locus  branches,  Including 
boxes,  titles,  axes,  labels,  poles,  and  zeros.  In  addition, 
this  routine  performs  the  search  for  locus  points  at  a 
specified  ZETA  of  Interest.  In  s-plane  the  search  Is  done 
along  a constant  zeta  line,  beginning  at  a distance  RAD  from 
the  origin.  In  z- plane,  the  search  begins  at  an  undamped 
natural  frequency  » RAD  and  spirals  from  the  z « 1 + jO 
point  In  to  the  origin.  ROOTll  draws  the  zeta  line  of  Interest 
and.  In  z -plane  (TSAMP  ^ 0) » It  draws  the  unit  circle. 

4.9  OVERLAY  (4,2)  --  PROGRAM  ROOTS. 

ROOTS  performs  only  one  function.  For  a given  value  ot 
GAIN,  It  calculates  the  closed-loop  transfer  function  In 
polynomial  form.  It  then  factors  the  denominator  polynomial 

and  prints  out  the  closed-loop  poles  at  the  GAIN  of  interest. 
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4.10  OVERLAY  (4.3)  --  PROGRAM  ROOT12. 

ROOT12  Is  the  workhorse  of  the  root  locus  programs.  It 
computes  the  points  on  each  branch  of  the  locus  within  the 
boundaries  of  calculation. 

The  method  used  to  calculate  the  root  locus  is  an  iterative 
search  for  one  locus  point  at  a time.  Since  points  on  the 
locus  are  only  desired  within  a set  of  boundaries  specified 
by  the  user,  there  are  four  types  of  root  locus  branches 
which  may  occur i 

1.  A branch  which  lies  entirely  within  the  boundaries. 

2.  A branch  which  starts  inside  the  boundaries  and  goes 
outside. 

3.  A branch  which  starts  outside  and  enters  the  region 
of  calculation,  or  which  reenters  the  region  after 
having  left  it. 

4.  A branch  which  lies  entirely  outside  the  boundaries. 

Branches  which  start  indide  the  boundaries  are  found  by 

beginning  at  each  pole  within  the  region  and  using  a circular 
search  routine  (to  be  described  later)  to  follow  the  branch 
until  it  reaches  a zero  or  goes  outside  the  boundary.  Branches 
which  enter  the  region  from  outside  are  found  by  searching  the 
boundaries  for  a branch  crossing  and  then  following  the  branch 
with  the  circular  search  routine  until  it  terminates  at  a zero 
or  leaves  the  region  again.  Branches  which  lie  entirely  outside 
the  region  of  calculation  are  skipped  and  an  informative 
message  printed. 

The  circular  search  routine  mentioned  above  is  used  after 
the  first  point  on  a given  branch  has  been  located.  This 
routine  simply  searches  around  a circle  of  radius  DEL  centered 
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at  the  point  already  known  until  another  locus  point  is 

found  which  satisfies  the  root  locus  180  or  0 degree  angle 

criterion.  The  new  locus  point  is  then  used  as  the  center  of  ^ 

another  circular  scan  and  the  process  repeats  until  a point  ^ * 

is  found  which  lies  outside  the  boundaries  or  which  is  less 

than  DEL  units  from  a zero. 

Fig.  6 shows  a flow  chart  depicting  how  each  branch  is 
located  by  R00T12.  First,  the  branches  beginning  at  each 
p>ole  are  traced  until  they  leave  the  boundaries  or  terminate  j 

at  zeros.  Then  the  boundaries  are  searched  for  other  incoming 
branches  and  these  branches  are  traced.  When  the  entire 
boundary  of  the  region  of  interest  has  been  searched,  every 
locus  branch  has  been  found  and  ROOT12  returns  control  to  the 
primary  overlay  ROOTIO.  ! 

4.11  OVERLAY  (4.4)  --  PROGRAM  ADAPT. 

This  overlay  was  written  to  allow  interfacing  of  subroutine  j 

READS  with  the  other  ROOTL  overlays.  Subroutine  READS  is  used 
throughout  TOTAL  in  place  of  the  standard  FORTRAN  READ  statement 
to  receive  data  Interactively  while  protecting  against  input 


errors.  Because  of  its  size,  there  was  not  enough  space  for  it 
in  any  of  the  existing  ROOTL  overlays  so  a new  overlay,  ADAPT, 
was  written. 

ADAPT  Is  simply  an  input  program  designed  to  ask  the  user 
for  all  the  Information  needed  for  a given  option  number.  It 
prints  out  all  prompting  messages,  calls  READS  Lv.  .'eceive  the 
user's  input,  and  stores  the  input  in  the  common  data  base  for 
use  by  the  other  root  locus  overlays. 
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Flow  chart  for  the  program  R00T12 


4.12  OVERLAY  (5.0)  --  PROGRAM  FREOR. 

FREQR  is  a very  short  executive  program  which  simply 
calls  two  secondary  frequency  response  overlays.  The  first 
overlay  called,  program  FRBjOUT,  performs  all  of  the  actual 
frequency  response  options.  If  a Calcomp  plot  is  generated, 
the  second  overlay,  program  PLOTSET,  is  called  to  finish  the 
details  of  the  plot.  FREJjOUT  and  PLOTSET  are  described  in 
Sections  4.13  and  4.14. 


( 
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4.13  OVERLAY  (5.1)  --PROGRAM  FREDOUT.  j 

FREQOUT  performs  all  discrete  and  continuous  frequency  I 

response  options.  A general  flow  chart  for  the  program  is  | 

given  in  Fig.  7. 

I 

I 

Execution  normally  begins  at  statement  10.  After  a few  { 

set-up  operations,  a seven  branch  computed  GO  TO  statement  is 
executed  to  send  the  program  flow  to  the  section  of  the 
program  responsible  for  executing  the  given  option  number,  NOPT. 

These  seven  sections  (one  for  each  frequency  response  option) 

are  Independent  of  each  other  and  they  all  return  control  to  i 

! 

statement  9999  which  terminates  FR£X)0UT.  j 

Because  FRBQOUT  has  been  divided  into  small,  independent  I 

sections  of  coding,  it  is  easy  for  a programmer  to  study  a 
particular  option  of  interest.  The  only  sections  which  really 
need  further  explanation  are  the  Calcomp  plot  options  (55  and 
56).  These  will  be  discussed  shortly. 

FRE3QOUT  uses  two  function  subprograms  to  do  the  actual 
frequency  response  calculations.  Function  FW(W)  returns  the 
magnitude  of  the  response  for  a given  value  of  frequency  W. 
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Function  AW(W)  returns  the  corresponding  phase  angle.  The 
units  of  frequency  used  (hertz  or  radians  per  second) . the 
magnitude  returned  (linear  or  decibels),  and  the  angle 
returned  (degrees  or  radians)  are  determined  Internally  by 

t 

FW  and  AW  based  on  the  values  of  the  logical  variables  HERTZ, 

DECIBEL,  and  DEGREE  respectively.  Whether  the  values  returned 

are  for  open-loop  or  closed-loop  transfer  functions,  and 

whether  the  function  Is  treated  as  discrete  or  continuous.  Is 

also  determined  Inside  FW  and  AW  based  on  values  of  CLOSED 

and  TSAMP  respectively.  The  values  of  these  variables  are  } 

specified  by  the  user  prior  to  selecting  the  option  desired  as 

described  In  Section  2.10  (option  93)  of  the  User*  s Manual 

for  TOTAL . FW  and  AW  are  described  completely  In  Section  5 

of  this  manual. 

As  mentioned  earlier,  the  Calcomp  plotting  routines 
(options  55  and  56)  are  of  sufficient  complexity  to  merit 
further  explanation.  The  expanded  flow  chart  of  these 
routines  given  In  Fig.  8 should  be  helpful  In  understanding 
the  following  discussion. 

< 

Options  55  and  56  differ  only  In  that  the  first  uses  a | 

linear  frequency  axis  while  the  second  uses  a logrlthmlc 
one.  Because  of  the  many  similarities,  much  of  the  coding  Is 
Identical  and  has  been  combined.  In  fact,  after  obtaining 
the  magnitude  and/or  angle  values  at  the  appropriate 
frequencies,  both  options  use  the  same  routine  to  finish 
scaling  and  plotting  the  data. 

Option  55  begins  at  statement  200  by  requesting  the  user 
to  specify  a frequency  range  of  Interest.  Option  56  begins 
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In  a similar  fashion  at  statement  300,  Both  options  then  ask 
the  user  to  specify  whether  to  plot  phase  only,  magnitude 
only,  or  both.  The  value  of  the  variable  "KIND"  is 
specified  by  the  user's  choice  asi  1 = ploc  phase,  2 = plot 
magnitude,  or  3 = plot  both.  KIND  is  then  used  as  an  internal 
flag  to  control  flow  throughout  the  rest  of  the  routine. 

The  first  set  of  calculations  performed  by  either  option 
is  to  fill  the  variable  "ARRAY"  with  800  phase  or  magnitude 
values -.depending  whether  KIND  = 1 or  KIND  = 2.  If  KIND  = 3, 
the  magnitude  values  are  computed,  scaled,  and  plotted  first 
and  the  process  then  repeated  for  the  phase. 

When  the  calculations  are  complete,  ARRAY  is  just  an 
array  of  800  points  to  be  plotted  at  even  intervals  and  it  is 
no  longer  necessary  to  know  whether  the  points  are  spaced 
linearly  or  logrithmically . (Logrithmically  spaced  points  on 
a log  axis  are  drawn  the  same  as  linearly  spaced  points  on  a 
linear  axis.)  Thus,  both  options  transfer  control  to  statement 
215  at  this  point. 

Statement  215  begins  the  magnitude  scaling  routine  for 
an  arbitrary  array  of  800  magnitude  points.  These  points  are 
scaled  either  linearly  or  in  decibels,  depending  on  the  value 
of  the  logical  variable  DECIBEL.  Once  this  selection  is  made, 
the  user  is  asked  to  specify  the  desired  scale,  or  the  array 
is  scaled  automatically,  depending  on  the  logical  variable 
SCALE  which  the  user  can  define.  (See  option  93  in  Section  2.10 
of  the  User ' s Manual . ) 

After  the  axis  scale  has  been  determined,  flow  goes  to 


I 
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I 
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statement  255  and  the  magnitude  array  and  axis  are  plotted. 

The  program  then  terminates  or,  if  KIND  = 3,  it  cycles  back 
around  to  statement  320  or  340  to  load,  scale  and  plot  the 
phase  response. 

When  FREQOUT  finally  does  end  option  55  or  56,  it  returns 
control  to  the  primary  overlay  FREQR,  which  calls  program 
PLOTSETT  to  finish  the  plot. 


4.14  OVERLAY  (5,2)  --  PR0GR\M  PLOTSET. 

PLOTSLT  is  a short  program  which  draws  the  entire  Calcomp 
plot  for  options  55  and  56,  except  for  the  actual  response 
curves.  Its  job  includes  drawing  the  boxes,  axes,  title,  labels, 
and  grid  lines  using  standard  Calcomp  routines. 


4.15  OVERLAY  (6.0)  --  PROGRAM  READER. 

READER  is  the  program  in  TOTAL  responsible  for  all 
interactive  functions.  It  receives  all  input  from  the  user 


when  in  OPTION  mode  and  translates  it  while  checking  for 
errors  into  a coded  set  of  numerical  commands  which  TOTAL 


can  execute.  R&\DER  also  receives  all  input  from  the  user  in 
CALCULATOR  mode  and  performs  all  calculator  operations. 

READER  Is  essentially  a compiler.  It  reads  input  from  the 
user  one  80-character  line  at  a time  and  translates  the 


character  patterns  into  a sort  of  "machine  language"  of 
numbers  which  can  be  easily  used  for  branching  with  F0RTR,\N 
IF  and  computed  GO  TO  statements.  The  compiler  is  capable  of 
recognizing  a large  variety  of  character  patterns  includingi 
command  names,  variable  names,  indicies,  numbers,  equations. 
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options,  several  special  characters  such  as  "$"  and  It 

can  also  handle  abbreviations  if  they  are  unique. 

The  compiled  results  from  READER  are  stored  in  two 
arrays  called  MCOMM  and  DATM.  Both  arrays  have  a dimension 
of  100  and  are  indexed  by  a pointer  MPT.  MCOMM  contains  the 
type  of  an  item  such  as  whether  it  is  a command  or  a variable, 
etc.  DATM  contains  the  specific  item  identification,  such  as 
which  command  or  which  variable.  For  example,  if  a series  of 
letters  was  found  to  be  the  name  of  a variable,  the  tact  that 
it  was  a variable  is  stored  in  MCOMM  while  its  specific 
variable  number  is  stored  in  DATM.  READER  recognizes  six 
different  types  of  input  items.  The  code  which  it  assigns  in 
MCOMM  to  represent  each  item  is  shown  belowi 


ITEM  TYPE 

MCOMM  CODE 

DATM  CONTENTS 

Command  Name 

1 

Command  Number 

Variable  Name 

2 

Variable  Number 

Numerical  Data 

3 

Number’s  Value 

Open  Parenthesis 

4 

Number  of  indicies  to  follow 

Equal  Sign 

5 

Number  of  equated  item  to 
follow 

Opt ion 

6 

Option  Number 

The  manner  in  which  REiDER  uses  this  code  is  best  illustrated 
by  an  example.  If  the  user  types  a line  of  input  as  follows t 
OPTION  > ECHO. ON  AM\T(8 . 5) =3 . 141 5 26 

RE/iDER  would  store  the  compiled  results  in  MCOMM  and  DATM  as 
shown  in  Fig.  9. 

As  each  item  in  the  input  is  coded,  it  is  stored  in  the 

MCOMM  and  DATM  array  elements,  currently  addressed  by  the  index 

pointer  MPT.  After  each  entry,  MIT  is  incremented  to  point 
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INPUT  COMPILED  OUTPUT  ARRAYS 

ITEM  MCOMM(MPtT  MTM(  MPT 
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at  the  next  empty  location  In  the  arrays.  When  an  entire 
line  has  been  compiled,  MPT  is  set  equal  to  1 to  point  at  the 
first  coded  instruction  and  READER  is  terminated.  These 
coded  instructions  are  then  interpreted  by  the  main  executive 


overlay  (with  the  help  of  program  DECODER  (overlay  (7,0))) 
and  executed  in  sequence.  ;\/hen  the  list  of  instructions  has 
been  exhausted,  READER  is  called  again  and  the  user  is  asked 
for  another  line. 

READER  has  a vocabulary  of  nearly  200  words  which  serve 
as  variable  and  command  names  which  the  user  may  type.  This 
vocabulary  is  stored  in  an  integer  array  called  TABLE,  which 
is  currently  dimensioned  to  allow  up  to  325  words.  When  the 
compiler  routine  encounters  a string  of  letters  (A  through  Z) 
that  are  separated  from  other  characters  in  the  input,  it 
stores  them  as  a unit  into  a variable  called  WORD.  The 
contents  of  this  variable  are  then  compared  with  every  name 
stored  in  the  TABLE  array  until  a unique  match  is  found.  The 
index  number  (position  in  the  array  TABLE)  of  the  name  which 
matches  becomes  the  compiled  code  for  that  name.  This  code  is 
then  stored  in  the  DATM  array  for  future  reference.  If  no 
match  is  found  anywhere  in  TABLE,  the  characters  in  WORD  are 
flagged  as  an  input  error. 

New  command  or  variable  names  may  be  added  to  TOTAL  by 
simply  adding  the  new  word  to  one  of  the  ten  DATA  statements 
which  define  the  TABLE  array.  Actually,  these  DATA  statements 
define  ten  smaller  tables  which  are  stacked  "end-to-end"  with 
EQUIVALENCE  statements  to  form  the  one  large  table  called  TABLE. 
Each  of  these  tables  contains  a particular  name  type  as 
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listed  belowt 


TABLE  NAME  TYPE  OF  NAME  IT  HOLDS 


TABA 

A 

table 

of 

up 

to 

50 

comnnand  names 

TABB 

A 

table 

of 

up 

to 

50 

real  constant  names 

TABC 

A 

table 

of 

up 

to 

25 

integer  constant  names 

TABD 

A 

table 

of 

up 

to 

25 

one  dimensional  array  names 

TABE 

A 

table 

of 

up 

to 

25 

complex  variable  names 

TABF 

A 

table 

of 

up 

to 

25 

two  dimensional  array  names 

TABG 

A 

table 

of 

up 

to 

50 

calculator  key  names 

TABH 

A 

table 

of 

up 

to 

25 

special  abbreviations 

TABT 

A table  of  up  to 
function  names 

25 

auxiliary  transfer 

TABJ 

A 

table 

of 

up 

to 

25 

auxiliary  matrix  names 

New  names  are  added  by  simply  adding  on  to  the  end  of  the 
appropriate  DATA  statement.  This  will  cause  one  of  the  325 
index  numbers  which  is  not  already  in  use  by  another  name  to 
become  active.  Thereafter,  anytime  the  new  name  is  typed,  its 
index  number  will  be  stored  in  the  DATM  array.  The  programmer 
can  then  use  this  number  to  perform  any  operation  he  wishes  to 
define  by  testing  for  it  anytime  the  DATM  array  is  used 
throughout  TOTAL. 

Complete  details  on  how  program  READER  actually  compiles 
the  user's  inputs  are  beyond  the  scope  of  this  manual.  The 
interested  reader  is  referred  to  Appendix  C for  a more 
complete  discussion. 


4.16  OVERLAYS 7.0)  --  PROGRAM  DECODER. 

DECODER  is  responsible  for  decoding  the  MCONLM  and  DATM 


arrays  set  up  by  READER  and  executing  the  resulting  instructions. 
A flow  chart  for  this  program  is  given  in  Fig.  10. 


As  described  in  Section  4.15,  READER  encodes  input  from 
the  user  as  one  of  six  possible  values  of  the  variable  MCOMM 
(MPT)  and  stores  additional  information  about  the  item  in 
DATM(MPT) . The  code  used  by  READER  is  repeated  below  for 


easy  reference. 

MCOMM (MPT) 

ITEM  NAME 

DATM(MPT)  CONTENTS 

1 . 

Command 

Command  Number 

2 

Varible 

Variable  Number 

3 

Numerical  Data 

Actual  value  of  datum 

4 

Open  Parenthesis 

Number  of  indicies  to  follow 

5 

Equal  Sign 

Number  of  equated  items  to 
follow 

6 

Option 

Option  Number 

Execution  of  DECODER  begins  with  a computed  GO  TO 
statement  which  sends  program  flow  to  one  of  six  sections  of 
the  program  depending  on  the  value  of  MCO>LM(MPT)  . The 
remaining  discussion  is  a detailed  description  of  these  six 
sections . 

The  Command  section.  If  MC0MM(MPT)=1 , the  program  flow 
jumps  to  statement  number  1000.  This  statement  is  another 
computed  GO  TO  statement  with  36  branches  selected  by  the 
value  of  DATM(MPT).  The  36  subsections  addressed  in  this 
manner  each  execute  one  of  the  36  commands  recognized  by  TOTAL. 
When  a particular  command  has  been  executed,  MPT  is  incremented  * 
and  control  is  returned  to  the  GO  TO  statement  at  the  beginning 
of  DECODER  for  the  next  instruction. 

Not  all  of  the  36  possible  commands  are  actually  executed 
by  DECODER.  Some  of  the  command  subsections  only  set  up  a 
request  in  the  NROUTE  array  for  some  other  overlay  to  be  called 
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and  return  control  to  the  main  executive  overlay  which 
executes  the  request.  In  the  case  of  COPY  (command  number  18), 
an  entire  overlay  is  needed  to  handle  all  the  possible  variations 
of  a single  command.  This  overlay  (Overlay  (15,0))  is  called 
directly  by  setting  MC0MM(MPT)=7  and  returning  to  the 
executive  through  statement  number  7000.  (When  the  executive 
sees  MC0MM(MPT)=7,  it  automatically  calls  overlay  (15,0)  to 
execute  the  COPY  command.) 

The  Variable  section.  If  MCOMM(MPT) =2 , the  program  jumps 
to  statement  number  2000  and  subroutine  MODIFY  is  called. 

MODIFY  is  an  elaborate  subroutine  which  lists  or  modifies  the 
variable  in  TOTAL'S  common  data  base,  whose  variable  number 
is  stored  in  D\TM(MPT) . The  exact  action  taken  depends  on  the 
value  of  MC0MM(MPT  ). 

If  MCOMM(MPT  ) equals  1.  2,  3.  or  6.  the  value  of  the 
variable  is  simply  listed  at  the  user's  terminal.  If  the 
variable  is  an  array,  all  elements  of  the  array  are  listed. 

No  further  action  is  taken  and  control  returns  to  the  beginning 


ui 


of  DECODER  to  fetch  the  next  Instruction. 

If  MC0MM(MPT-t-l)=4.  the  variable  is  known  to  be  subscripted 
with  the  number  of  indicies  stored  in  DATM(MPT+1).  The  actual 
index  values  are  then  obtained  from  DATM(MPT+2)  and  (if  there 
are  2 indicies)  DATM(MPT+3).  If  all  of  this  information  is 
followed  by  anything  other  than  MC0MM(LASTMPT+1 )=5,  the 
value  of  the  single  array  element  with  the  given  indicies  .is 
listed.  If  MC0MM(LASTMPT+1)=5  (where  LASTMPT  is  the  value  of 
MPT  which  points  to  the  location  in  DATM(MPT)  where  the  last 
index  value  was  obtained),  the  array  element  with  the  given 
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indicies  is  set  equal  to  the  variable  value  stored  in  the 
next  DATM  location  (DATM(LASTMPT+2) ) . 

If  MC0>N(MPT-»1)=5.  the  variable  is  known  to  have  been 
followed  by  an  equal  sign  in  the  original  input,  and  it  is 
assigned  the  value  of  the  number  or  variable  stored  in  the 
(MPT+2)  location. 

When  subroutine  MODIFY  has  finished,  it  sets  the  MPT 
pointer  to  point  to  the  next  instruction  following  the  last 
item  of  information  it  used  in  the  MCOMM  and  DATM  arrays. 

Control  is  then  returned  to  the  beginning  of  DECODER  to  get 
the  next  instruction. 

Numerical  data,  open  parenthesis,  and  equal  sip.n  sections. 
These  three  sections  print  error  messages  and  when  TOTAL  is 
operating  properly,  should  never  be  used.  MC0MM(MPT)=3,  4,  or 
5 should  only  ever  occur  following  a variable  name  and  are 
intended  only  for  use  by  subroutine  MODIFY  as  described  above. 
Since  MODIFY  always  moves  the  MPT  pointer  past  these  numbers 
when  it  has  finished  using  them,  they  should  never  be 
encountered  when  the  main  GO  TO  statement  at  the  beginning  of 
DECODER  is  executed.  These  sections  are  only  included  to  protect 
against  abrupt  termination  of  TOTAL  in  event  that  an  error 
occurs  in  one  of  the  encoding  or  decoding  routines. 

Option  section.  If  MC0MM(MPT)=6,  DECODER  jumps  to  state- 
ment number  6000. . Since  the  option  number  that  must  be 
executed  may,  in  general  be  found  in  any  one  of  the  17  primary 
overlays,  DECODER  simply  returns  control  to  the  main  executive 
and  allows  it  to  call  the  appropriate  overlay  needed  to 
execute  the  option. 
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Termination  of  DECODER.  \men  MCOMM(MPT)=0,  the  list  of 
instructions  stored  in  MCOMM  and  DATM  has  finally  been  exhausted 
and  DECODER  ends.  The  main  executive  overlay  immediately 
calls  READER  and  the  user  is  asked  for  further  instructions 
with  the  familiar  prompt*  OPTION  > . 

4.17  OVERLAY  (9.0)  --  PROGRAM  HELP. 

HELP  is  a program  consisting  predominantly  of  PRINT 
statements.  Its  sole  purpose  is  to  give  help  on  each  of 
TOTAL’S  options.  Its  structure  consists  of  a single  computed 
GO  TO  statement  with  a branch  for  each  option.  When  a 
particular  branch  is  executed,  the  program  simply  writes  a 
short  help  message  and  then  terminates,  returning  control  to 
the  main  overlay. 

4.18  OVERLAY  (10.0)  --  PROGRAM  FRACTOR. 

FRACTOR  is  a program  whose  sole  purpose  is  to  call 
subroutine  DMULR  to  factor  a polynomial.  The  program  receives 
the  polynomial  to  be  factored  from  any  other  overlay  in  TOTAL 
through  labeled  common.  After  checking  to  ensure  that  the 
highest  power  coefficient  of  the  polynomial  is  non-zero  (and 
hence  its  degree  correct),  FRACTOR  loads  the  polynomial  into 
a double  precision  array  and  then  calls  DMULR. 

VTien  DMULR  finishes  factoring  the  polynomial,  it  returns 
the  roots  as  real  and  imaginary  parts  in  two  separate  double 
precision  arrays.  After  zeroing  the  imaginary  parts  that  are 
within  10"^^  of  zero,  FRACTOR  copies  the  results  into  an  array 


I 


I 


I 


in  labeled  common  where  they  can  be  used  by  other  programs 
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and  returns  control  to  the  main  overlay. 


4.19  OVERLAY  (U.D)  --  PROGRAM  TTYPLOT. 

TTYPLOT  produces  a printer  plot  of  the  root  locus  for 
option  48.  It  is  called  only  after  all  points  on  the  root 
locus  have  been  calculated  and  stored  as  x-y  coordinate  pairs 
on  local  file  TAPElO  by  the  root  locus  programs  (overlay  (4,0)). 
TTYPLOT  then  reads  these  joints  from  TAPEIO  and  puts  them  on 
the  plot. 

The  printer  plot  is  first  set  up  in  an  array  called 
GRAPH(61,7l)  by  storing  alphanumeric  characters  for  the 
border,  axes,  grid,  poles,  zeros,  and  locus  points  at 
appropriate  locations  in  the  61  x 71  matrix.  The  plot  is  then 
generated  by  printing  the  GRAPH  array  contents,  one  row  at  a 
time,  in  alphanulneric  format. 

Points  are  placed  in  the  GRAPH  array,  by  mapping  the  region 
of  the  complex  plane  defined  by  the  locus  boundaries  AA,  BB, 

CC,  and  DD  into  a discrete- valued  array  61  units  wide  and  a 
proportional  number  of  units  long.  This  is  accomplished  by 
simply  dividing  the  length  of  the  real  axis  to  be  plotted  by 
60  and  allowing  the  result  to  represent  one  unit  on  the  real 
axis  of  the  plot.  Since  most  printers  print  10  characters 
per  inch  horizontally  and  only  6 lines  per  inch  vertically, 
one  unit  on  the  imaginary  axis  of  the  plot  is  chosen  to  be 
10/6  times  the  size  of  a real  axis  unit.  Once  these  units 
have  been  chosen,  each  locus  point  is  rounded  to  its  nearest 
discrete  value  on  the  plot  and  an  alphanumeric  character 

stored  In  that  location  in  the  GRAPH  array. 
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TTYPLOT  was  written  as  a completely  general  program  and  could 
be  used  to  plot  any  set  of  x-y  points  stored  on  TAPEIO  (not 
just  root  locus  points.) 


! 

4.20  OVERLAY  (13.0)  --  PROGRAM  MISCELL. 

|..  This  overlay  is  designed  to  serve  as  a catch-all  for 

i'  miscellaneous  options  which  do  not  fit  into  any  other  overlay 

(either  logically  or  in  terms  of  actual  available  space) . At 
present,  MISCELL  only  performs  one  option:  Option  93. 

The  first  executable  statement  encountered  in  MISCELL  is: 
IF(NOPT.Eg.93)  GO  TO  93 

which  sends  program  flow  to  statement  93  if  the  option  number, 
NOPT,  is  93.  If  NOPT  4 93,  an  error  message  is  printed  and 
: MISCELL  is  terminated.  Additional  options  may  be  added  to  this 

I overlay  by  simply  including  another  IF  statement.  For 

I 

I example,  to  add  option  118,  one  would  insert  the  statement: 

i 

"IF(N0PT.EQ.118)  GO  TO  118"  after  the  first  IF  statement  and 
then  add  the  new  routine  beginning  statement  118. 


4.21  OVERLAY  (14.0)  --  PROGRAM  M\TRIX. 

MATRIX  is  just  an  executive  program  which  directs  the  ! 

selection  of  two  secondary  overlays  called  MATS  and  M(\TOPR.  ? 

These  overlays  are  discussed  in  the  following  two  sections.  ? 

! 

4.22  OVERLAY  (14.1)  --  PROGRAM  M\TS. 

Program  MATS  is  responsible  for  p)arts  of  the  execution 

C‘  of  options  11,  12,  13,  14,  15,  16,  17,  18,  19,  25,  26,  77,  78,  ^ 

' and  79.  Each  of  these  options  is  performed  by  a separate 
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piece  of  coding  addressed  by  a computed  GO  TO  and  several  IF 
statements  at  the  beginning  of  the  program. 

MATS  is  primarily  designed  to  start  every  matrix-related 
option  in  TOTAL  by  obtaining  any  input  which  may  be  needed. 
Since  options  11  through  17  involve  only  the  input  of  data, 
MATS  performs  them  entirely.  For  other  options,  MATS  only 
receives  the  needed  input  and  leaves  the  actual  computations 
for  MATOPR  to  perform  after  MATS  has  terminated. 

By  dividing  the  functions  performed  by  the  two  programs 
in  this  manner,  MATOPR  does  not  need  to  use  the  large  input 
subroutine  READS  at  all  and  all  of  its  space  can  be  devoted 
to  performing  the  actual  matrix  operations. 


4 .23  OVERLAY  (14.2^ 


PROGRAM  NIATOPR. 


As  has  been  mentioned,  MATOPR  performs  most  of  the  matrix 
operation  options  for  TOTAL.  Specifically,  it  is  responsible 
for  options  25,  26,  27,  71,  72,  73,  74,  75,  and  76.  MATOPR 
makes  extensive  use  of  subroutines  in  performing  its  many 
functions.  These  subroutines  include  PHOFS,  FACTO,  ECHOS, 
MADD,  MATECHO,  GENMMPY,  MINV,  TRANPOS,  and  GTFIfTF  and  are 
discussed  in  Section  5. 


COPYIER  is  a program  designed  to  implement  the  COPY 
command  providing  the  ability  to  transfer  variables  from  one 
location  to  another  in  TOTAL’S  common  data  base.  When  COPYIER 
Is  called,  the  variable  names  following  the  COPY  command  are 
read  as  variable  numbers  from  DATM(MPT+1)  and  DATM(MPT+2) . 

B-43 


These  variables  may  be  of  the  following  types i 


h 


I 


I 


( 


Local  polynomial  arrays  in  labeled  common 

Local  complex  root  arrays  in  labeled  common 

Local  matrix  arrays  in  labeled  common 

Local  transfer  functions  in  labeled  common 

Auxiliary  matrix  arrays  in  the  mass  storage  file  MEMAUX 

Auxiliary  transfer  function  in  MEMAUX 

Depending  on  what  kind  of  transfer  is  to  be  performed, 

COPYIER  selects  one  of  ten  routines  to  perform  the  operation. 

A list  of  routines  which  can  be  selected  is  given  belowj 

Copy  from  one  polynomial  to  another 

Copy  from  one  root  array  to  another 

Copy  from  one  local  matrix  to  another 

Copy  from  a local  matrix  to  an  auxiliary  matrix 

Copy  from  an  auxiliary  matrix  to  a local  matrix 

Copy  from  one  auxiliary  matrix  to  another 

Copy  one  local  transfer  function  to  another 

Copy  a local  transfer  function  to  an  auxiliary  one 

Copy  an  auxiliary  transfer  function  to  a local  one 

Copy  one  auxiliary  transfer  function  to  another 


( 


Each  of  these  operation  is  performed  by  a separate  j 

1 

section  of  coding  in  the  program.  When  the  transfer  of 

information  is  complete,  COPTIER  returns  control  to  the  main 

overlay . , 

! 

4.25  OVERLAY  (16.0)  --  PROGRAM  XFORMS.  • 

I 

i 

XFORMS  performs  a variety  of  transformations  between  i 

continuous  and  discrete  transfer  function  representations. 

The  program  is  divided  into  nine  sections  which  independently 
perform  options  81  through  89.  These  sections  may  be  classified 
according  to  three  types  of  operation  as  described  below. 

Options  81  and  84  use  a partial  fraction  expansion 
technique  to  perform  impulse  invariant  transformations  between 
s and  z transfer  functions.  In  both  cases,  the  transfer 
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function  of  Interest  Is  expanded  Into  first  order  terras,  the 
Individual  poles  transformed,  one  at  a time,  from  one  domain 
into  the  other,  and  the  first  order  terras  multiplied  together 
to  form  the  transformed  transfer  function. 

Options  82,  83,  85,  86,  and  89  use  a single  subroutine 
to  perform  substitution  of  the  formi 

s = ALPHA  • (z  + A)/(z  + B) 
or 

z = ALPHA  * (s  + A)/(s  + B) 

Each  option  simply  defines  ALPHA,  A,  and  B as  needed  for  its 
particular  transformation  and  then  calls  subroutine  BI?ORM 
(ALPHA, A, B)  to  perform  the  transformation  on  the  contents  of 
CLTF. 

Options  87  and  88  simply  call  appropriate  subroutines  to 
perform  transformations  on  systems  represented  in  matrix  form. 

When  XFORMS  has  completed  a transformation,  control  is 
returned  to  the  main  overlay  through  statement  number  9999. 


I 


k 


C 
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4.26  OVERLAY  (17.0^  --  PROGRAM  BLOCKER. 

BLOCKER  performs  all  block  diagram  manipulation  options 
for  TOTAL,  including  options  21,  22,  23,  24,  28,  and  29.  The 
program  is  divided  into  six  sections  addressed  by  a single 
computed  GO  TO  statement.  Each  program  section  performs  its 
function  using  a series  of  polynomial  manipulation  subroutines 
Including  POLYADD,  POLYSUB,  POLYMLT,  FACTO,  and  EXPAND.  These 
subroutines  are  described  in  Section  5.  The  actual  operations 
performed  using  these  subroutines  are  described  in  detail  in 
Section  2.3  of  the  User’s  Manual  for  TOTAL. 
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SECTION  5.  DESCRIPTION  OF  SUBPROGRAMS 

1 

< 

t 

1 

r' 

( 

This  section  Is  written  to  document  each  of  the 

1 

i 

1 

» 

subprograms  used  by  TOTAL.  It  Is  Intended  to  describe  the 

f 

1 

function  and  use  of  each  routine  In  sufficient  detail  to  allow 

1 

1 ' 

I-. 

1 

a programmer  to  make  Intelligent  use  of  It  whenever  the  need 

h 

arises.  A cross  listing  of  subprograms  and  main  programs  used 

i 

t^, 

In  TOTAL  Is  presented  In  Table  II  for  reference.  From  this 

i 

table  one  may  see  which  subprograms  are  used  In  any  given 

i 

1 

1 

program  and  also  which  programs  use  any  given  subprograms.  In 

addition,  page  numbers  are  Included  so  that  Table  II  may  also 

be  used  as  a table  of  contents  for  the  subprograms  described 

• 

In  this  section. 

! 

For  each  subprogram,  a standard  sequence  of  Information  Is 

! 

i 

1 

( 

presented  Including  a description,  the  calling  sequence,  any 

] 

! 

1 

( 

COMMON  statements  used,  a definition  of  symbols,  explanatory 

\ 

) 

i 

notes,  and  a list  of  subprograms  used.  When  COMMON  statements 

are  tabulated,  only  the  variables  In  each  statement  that  are 

! 

actually  used  by  the  subprogram  are  listed.  Any  variables  not 

i 

* 

used  (but  presumably  used  elsewhere  In  TOTAL)  are  represented  by 

■ 

i 

t 

1 

* 

asterisks  to  preserve  variable  position  In  the  COMMON  statement. 

1 

i 

1 

i 

1 

5.1  FUNCTION  FT. 

1 

! 

‘ 

The  function  FT  obtains  the  value  of  a continuous  time 
response  function  for  a given  value  of  T using  the  function  FTT 
and  performs  a superposition  of  two  responses  In  the  case  of 
a pulse  Input. 

y 

1 

0 
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Calling  Sequence. 

X « FT(T) 

COMMON  statements  used. 

COMMON/PARTL  5 /* , RWI DTH , * , * , INPUTR 
Definition  of  symbols. 

T = Time  at  which  response  is  to  be  evaluated 
INPUTR  = 4 input  is  a pulse 

i 4 input  is  an  impulse,  step,  ramp,  or  sinusoid 
RWIDTH  = Width  of  input  pulse  in  seconds 

N5tes . 

(1)  If  INPUTR  ^ 4,  FT  calls  FTT  once  and  simply  returns 
the  results  to  the  calling  program.  If  INPUTR  = 4, 

FTT  is  called  twice  for  values  of  time  T and 
T-RWIDTH  and  the  results  subtracted  using  superstition 
to  obtain  the  pulse  response. 

Subprograms  used. 

FTT 

5.2  FUNCTION  FTT. 

The  function  FTT  calculates  the  value  of  a continuous 
time  response  function  for  a given  value  of  T using  information 
placed  in  common  by  the  program  TIMER. 

Calling  sequence. 

X « FTT(T) 

COMMON  statements  used. 

COMMON/PARTLl /22Z ( 50) , XR,NXX, YYY( 50) , W( 50) 
COMMON/PARTL2/CR(50) , EC( 50) , OM(50) , FE( 50) ,LL 

Definition  of  symbols. 

T = Time  in  seconds  at  which  function  is  to  be  evaluated. 
The  variables  in  COMMON  form  the  coefficients  of  the 
function  to  be  evaluated  which  has  the  form. 


where 


FTT-* 

r Fi(i)  - ♦ r 1 

I«1  1=1 

Fl(I) 

» ZZZ(I)  ★ EXP(XR*T) 

F2(I) 

« YYY(I)  * EXPC»^(I)*T 

F3a) 

« CR(I)  * EXP(EC(I)*T! 
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* SIN(OM(I)*T  ♦ FE(I) 

Preceding  page  blank 


5.3  SUBROUTINE  PROPGAT. 


The  subroutine  PROPGAT  Iterates  a recursive  difference 
equation  of  the  formi 

c(k)  = A(l)r(k)  + A(2)r(k  - 1)  ♦ ...  •♦•  A(N)r(k  - N ♦ 1) 

- B(2)c(k  - 1)  - ...  - B(N)c(k  - N + 1) 

to  obtain  the  current  value  of  c(k)  given  the  past  N Inputs  and 
outputs . 

CalllnR  sequence. 

CALL  PROPGAT  (A, B,R,C,N,K) 

Definition  of  symbols. 

A * Vector  array  of  coefficients  of  R terms 

B * Vector  array  of  ceofflclents  of  C terms 

R = Vector  array  of  past  N Inputs  (Including  present) 

C = Vector  array  of  past  N outputs  (including  present) 

N = Order  of  difference  equation 
K » Current  Index  value 

Notes. 

(1)  The  value  of  r(k  - M)  Is  stored  In  R(M  +1)  and 
similarly,  the  value  of  c(k  - M)  Is  stored  In 
C(M  ♦ 1) , and  so  on. 

Subprograms  used. 

RIN 


5.4  FUNCTION  RIN. 

The  function  RIN  computes  the  current  Input  r(k)  for  use 
by  PROPGAT.  It  Is  capable  of  generating  an  Impulse,  step, 
ramp,  pulse,  or  sinusoid  depending  on  the  value  of  INPUTR. 

Calling  sequence. 

X - RIN(K) 

COMMON  statements  used. 

COMMON /DIG IT /TSAMP 

C0MM0N/PARTL5  /RSLOPE,  RWIDTH,  RHIGHT,  ROMEXJA , INPUTR 
Definition  of  symbols. 

K ■ Index  value  of  the  sampling  Instant  In  question 
TSAMP  ■ Sampling  time  In  seconds 
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RSLOPE 

RWIDTH 

RHIGHT 

ROMEGA 

INPUTR 


Ramp  Input  slope  in  units/sample 
Pulse  Input  width  in  samples 
Magnitude  scale  factor  for  any  input 
Frequency  of  sinusoidal  input 

1 RIN  = RHIGIfT  if  K = 0 

2 RIN  = RHIGHT  if  K > 0 

3 RIN  = SLOPE  * K if  K > 0 

4 RIN  = RHIGHT  if  0 < K < RHWIDTH 

5 RIN  = RHIGHT  * SIN(ROMEGA*TSAMP*K) 


5.5  SUBROUTINE  POLAR. 

The  subroutine  POLAR  converts  a set  of  cartesian 
coordinates  AC  and  BD  to  polar  form  as  a magnitude  FACT  and 
an  angle  FACTR. 

Calling  sequence. 

CALL  POLAR 

COMMON  statements  used.  ' 

COMMON/POLARC/AC, BD, FACT, FACTR 

Definition  of  symbols. 

AC  = x-coordinate 
BD  = y-coordinate 

FACT  = Magnitude  = SQRT(AC**2  ♦ BD**2) 

FACTR  = Angle  in  degrees  = ATAN(BD/AC) 

Notes. 

(1)  The  angle  FACTR  is  returned  as  a value  between  ♦ 71  • 


5.6  SUBROUTINE  SPECS. 

The  subroutine  SPECS  finds  the  continuous  time  response 
figures  of  merit  rise  time,  duplication  time,  peak  time,  setting 
time,  peak  value,  and  final  value.  It  also  writes  these  values 
to  an  output  device. 

Calling  sequence. 

CALL  SPECS 

COMMON  statements  used. 

COMMON/TOTL14/*,*,*,*,*,*,*,*,N60 

COMMON/PARTLl /ZZZ( 50) , XR , NXX, YYY( 50) , W( 50) 
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COMMON/PARTL2/CR(50) . EC(59) ,OM(50) , FE(50) ,LL 
C0MM0N/PARTL3/FINVAL, DEL 

Definition  of  symbols. 

NGO  = 6 Output  is  written  to  file  ANSWER 

= 7 Output  is  written  to  user's  terminal 
FINVAL  = Final  value  of  response  computed  by  program  TIMER 
DEL  = Iteration  step  size 

The  remaining  variables  listed  above  are  defined  in 
Section  5.2. 

Notes . 

(1)  This  subroutine  finds  every  peak  in  the  time  response 
over  a range  of  time  from  0 to  eight  times  the 
longest  time  constant,  and  picks  the  biggest  one. 

Subprograms  used. 

FT  ZEROIN  PEAK 


5.7  SUBROUTINE  ZEROIN. 

The  subroutine  ZEROIN  finds  the  first  value  of  T after 
T = TMIN,  where  the  function  FT(T)  equals  some  specified  value 
GOAL  using  an  iterative  search  procedure.. 

Calling  sequence. 

CALL  ZEROIN(T .GOAL , TMIN , TNiAX, LUCK) 

COMMON  statements  used. 

C0MM0N/PARTL3 /FINVAL, DEL 
Definition  of  symbols. 

T « Value  of  time  where  FT(T)  = GOAL 

GOAL  a Value  of  FT  for  which  a corresponding  time  is  to 
be  found 

TMIN  « Starting  value  of  time  range  to  be  searched 
TMAX  a Final  value  of  time  range  to  be  searched 
LUCK  a 0 No  such  time  was  found  between  TMIN  and  TMAX 
a 1 The  search  for  T was  successful 
FINVAL  a Final  value  of  the  function 

DEL  a Starting  step  size  of  search  (chosen  by  SPECS  to  be 
one  tenth  of  the  shortest  period  of  oscillation  in 
the  function.) 
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Notes . 

(1)  If  the  correct  T cannot  be  found,  the  value  of  T 
returned  Is  T = 0. 


* 

f 


I 


( 


(2)  The  Iterative  search  used  Is  continued  until  FT(T) 
is  within  jq-6  * FINVAL  of  the  specified  GOAL, 

Subprograms  used. 

FT 


5.8  SUBROUTINE  PEAK. 

The  subroutine  PEAK  finds  the  first  value  of  T after 
T = TMIN  where  the  slope  of  FT(T)  is  zero,  using  an  Iterative 
search  technique. 

Calling  sequence. 

CALL  PEAK(T, TMIN, TMAK, LUCK) 

COMMON  statements  used. 

COMMON/PARTL3/FINVAL, DEL 

Definition  of  symbols. 

T = Value  of  time  where  slope  of  FT  is  zero 
TMIN  = Starting  value  of  time  range  to  be  searched 
TMAX  = Final  value  of  time  range  to  be  searched 
LUCK  =0  No  peak  was  found  between  TMIN  and  TMAX 
= 1 The  search  was  successful 
FINVAL  = Final  value  of  the  function 
DEL  = Starting  step  size  of  the  search 

Notes . 

(1)  If  the  function  is  increasing  at  TMIN,  the  search 
looks  for  a local  maximum.  If  the  function  is 
decreasing,  the  search  looks  of  a local  minimum. 

(2)  The  search  is  terminated  when  the  value  of  TMAX  is 
reached  or  when  three  values  of  time  are  found  close 
enough  together  that  the  value  on  either  side  of  the 

peak  changes  by  less  than  lO"^  * FINVAL  units. 
Subprograms  used. 

FT 
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5.9  SUBROUTINE  ECHOS. 


The  subroutine  ECHOS  Is  an  output  routine  which  is  used 
to  print  polynomial  coefficients  and  roots  is  a compact  table. 

Callinr.  sequence. 

CALL  ECHOS (ROOT,  POLY,  NP,  PK) 

COMMON  statements  used. 

COMMON /TOTLl 4/  *,  *,  *,  *,  *,  *,  *,  NGO 

Definition  of  symbols. 

ROOT(50,2)=  Array  of  roots  to  be  printed 
P0LY(51)  = Array  of  coefficients  to  be  printed 
NP  = Order  of  polynomial  to  be  printed 
PK  = Polynomial  constant  to  be  printed 
NGO  = 6 Output  is  printed  on  TAPE6  = ANSWER 
* 7 Output  is  printed  on  TAPE?  = OUTPUT 


5.10  SUBROUTINE  POL ECHO. 

The  subroutine  POL ECHO  is  an  output  routine  which 
tabulates  polynomial  coefficients  to  ten  decimal  places  with 
corresponding  index  numbers. 

Calling  sequence. 

CALL  POL ECHO (POLY,  NP) 

COMMON  statements  used. 

COMMON /TOTLl 4/*,  *,  *,  *,  *,  *,  *,  *,  NGO 
Definition  of  symbols. 

POLY(51)  = Array  of  polynomial  coefficients  to  be  printed 
NP  * Order  of  polynomial 

NGO  = 6 Output  is  printed  on  TAPE6  = ANSWER 
« 7 Output  is  printed  on  TAPE7  = OUTPUT 


5.11  SUBROUTINE  RTECHQ. 

The  subroutine  RTECHO  is  an  output  routine  designed  to 
print  out  the  real  and  imaginary  parts  of  an  array  of  polynomial 
roots  to  ten  decimal  places.  The  routine  also  prints  an  index 
number  for  each  root. 
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Calling:  sequence. 

CALL  RT ECHO ( ROOT, NP) 

COMMON  statements  used. 

COMMON/TOTL14/*,  *,  *,  *,  *,  *,  *,  *,  NGO 

t 

Definition  of  symbols. 

ROOT(50,2)  = Array  of  50  complex  numbers  where  R00T(I,1) 
is  the  real  part  and  ROOT (I, 2)  is  the 
imaginary  part  of  the  I th  root  to  be  printed 
NP  = Number  of  roots  to  be  printed 
NGO  = 6 Output  is  printed  on  TAPE6  = ANSWER 

= 7 Output  is  printed  on  TAPE?  = OUTPUT  i 


5.12  SUBROUTINE  MATECIIO. 

The  subroutine  MATECHO  is  an  output  routine  designed  to 
print  the  elements  of  a matrix  of  arbitray  dimensions. 

CallinR  sequence. 

CALL  HATECHO(AMAT,NA,MA) 

COMMON  statements  used. 

C0MM0N/T0TL14/*,  *,  *,  *,  *,  *,  *,  *,NG0 

Definition  of  symbols. 

AMAT(10,10)  = Matrix  of  elements  to  be  printed 

NA  = Number  of  rows  in  AMAT 

MA  = Number  of  columns  in  AMAT 

NGO  = 6 Output  is  printed  on  TAPE6  = ANSWER 
= 7 Output  is  printed  on  TAPE?  = OUTPUT 

Notes. 

(1)  If  the  matrix  to  be  printed  has  more  than  five 
columns,  and  NGO  = 6,  each  row  of  the  first  five 
columns  is  tabulated  first  followed  by  any  remaining 
columns  lower  on  the  output  page.  If  NGO  = 7,  all 
columns  are  tabulated  side-by-side. 
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5.13  SUBROUTINE  TFECHO. 

The  subroutine  TFECHO  is  an  output  routine  which  tabulates 
the  numerator  and  denominator  polynomial  coefficients  and 
roots  of  a transfer  function  in  a compact  form. 

Calling  sequence. 

CALL  TF ECHO ( NAME , L ET , Z ERO , POL E , POL YD , GNP , GDK , NZ , NP ) 

COMMON  statements  used. 

C0MM0N/T0TL14/*,  *,  *,  *,  *,  *,  *,  NGO 

Definition  of  symbols. 

NAME  = Left  justified  Holerith  constant  containing  the 
initials  of  the  transfer  function  to  be  printed. 
These  initials  have  the  letters  TF  appended  to 
them  forming  the  transfer  function  name. 

LET  = Number  of  letters  stored  in  NAME  (usually  1 or  2) 
ZERO(50,2)  = Complex  array  of  transfer  function  zeros 
POLE(50,2)  = Complex  array  of  transfer  function  poles 
P0LYN(51)  = Array  of  denominator  coefficients 
GNP  = POLYN(l) 

GDP  = POLYD(l) 

NZ  = Order  of  transfer  function  numerator 
NP  = Order  to  transfer  function  denominator 
NGO  = 6 Output  is  printed  on  TAPE6  = ANSWER 
= 7 Output  is  printed  on  TAPE?  = OUTPUT 


5.14  SUBROUTINE  POLYADD. 

The  subroutine  POLYADD  adds  polynomial  A and  polynomial 
B to  form  polynomial  C. 

Calling  sequence. 

CALL  POLYADD(A,  B,  C,  NA,  NB,  NC,  AK,  BK.CK) 

Definition  of  symbols. 

A(51),B(51)  Polynomials  to  be  added  where  A(l)  is  the 
highest  order  coefficient  of  polynomial  A 
and  so  on. 

C(51)  = Resulting  sum  of  A and  B 

NA,NB,NC  = Order  of  A,  B,  and  C respectively 

AK  = A(l) 

BK  = B(l) 

CK  « C(l) 
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5.15  SUBROUTINE  PQLYSUB. 


The  subroutine  POLYSUB  subtracts  polynomial  B from 
polynomial  A to  form  polynomial  C. 

Callinp.  sequence. 

CALL  POLYSUB (A , B , C , NA , NB . NC , AK , BK , CK) 

Definition  of  symbols. 

See  section  5.14 
Subprograms  used. 

POLYADD 


5.16  SUBROUTINE  POLYMLT. 

The  subroutine  POLYMLT  multiplies  polynomial  A by 
polynomial  B to  form  polynomial  C.  If  the  order  of  C is 
greater  than  50  the  routine  aborts. 

Calling  sequence. 

CALL  POLYMLT(A,B,C.NA,N0,NC,AK,BK,CK),  RETURNS  (number) 
Definition  of  symbols. 

Number  = Statement  number  in  calling  program  to  which 
control  is  to  be  returned  if  the  product  C 
has  an  order  greater  than  50. 

(All  other  symbols  --  see  Section  5.14) 


5.17  SUBROUTINE  EXPAND. 

The  subroutine  EXPAND  expands  the  roots  of  a polynomial 
into  a corresponding  set  of  polynomial  coefficients. 

Calling  sequence. 

CALL  EXPAND( ROOTR , ROOT I , GA IN , NF , POLY) 

Definition  of  symbols. 


ROOTR(50) 

ROOTI(50) 


Array  of  root  real  parts 
Array  of  root  Imaginary  parts 
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GAIN  * Numerical  constant  to  be  multiplied  together 
with  the  roots  to  form  the  coefficients 
NF  = Number  of  roots  to  be  expanded 

P0LY(51)  = Resulting  array  of  coefficients  where  POLY(l) 
is  the  highest  order  coefficient  and  is  always 
equal  to  GAIN. 


( 


5.18  SUBROUTINE  FACTO. 

The  subroutine  FACTO  is  a setup  subroutine  which  calls 
subroutine  DMULR  to  factor  a polynomial. 

Calling  sequence. 

CALL  FACTO ( POL YQ , ROOTQ , NQ , PQK) 

Definition  of  symbols. 

P0LYQ(51)  = Array  of  coefficients  of  polynomial  to  be 

factored  where  POLYQ(l)  is  the  highest  order 
coefficient. 

ROOTQ (50, 2)  = Array  of  resulting  roots  where  ROOTQ (1,1) 

is  the  real  part  of  the  I th  root  and  ROOTQ (I, 2) 
is  the  imaginary  part. 

NQ  = Polynomial  order 
PQK  = POLYQ(l) 

Subprograms  used. 

DMULR 

5.19  SUBROUTINE  DMULR. 

The  subroutine  DMULR  is  a polynomial  factoring  subroutine. 
Calling  sequence. 

CALL  DMULR(COE,Nl,ROOTR,ROOTI) 

Definition  of  symbols. 

C0E(51)  = Double  precision  array  of  coefficients  of  the 
polynomial  to  be  factored 
N1  * Order  of  polynomial 

ROOTR(50)  a Double  precision  array  of  real  parts  of 
resulting  factors 

ROOTI(50)  3 Double  precision  array  of  corresponding 
imaginary  parts. 


f 
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5.20  SUBROUTINE  MADD. 

The  subroutine  MADD  adds  or  subtracts  matrix  A and 
matrix  B to  form  matrix  C.  If  A and  B do  not  have  some 
dimensions,  the  routine  aborts. 

Calling  sequence. 

CALL  MADD(A,B,C,NA,NB,NC,MA,MB,MC,S) ,RETURNS(number) 

Definition  of  symbols. 

A(10, 10) , B(10, 10)  Input  matrices 
C(10,10)  Output  matrix 

NA,NB,NC  Number  of  rows  In  A,  B,  and  C 

MA,MB,MC  Number  of  columns  In  A,  B,  and  C 

S = +1  B Is  added  to  A 

= -1  B Is  subtracted  from  A 
Number  = The  statement  number  In  the  calling  program  to 

which  control  Is  to  be  returned  If  the  subroutine 
aborts . 

Notes . 

(1)  Every  coefficient  In  the  B matrix  Is  multiplied  by 
S and  the  result  added  to  the  A matrix. 


5.21  SUBROUTINE  GENMMPY. 

The  subroutine  GEIN,,PY  post-multlplles  the  matrix  A by 
the  matrix  B and  stores  the  results  In  matrix  C.  If  A and  B 
do  no  conform,  the  routine  aborts.  • 

Calling  sequence 

CALL  GENMMPY(A,B,C,NA,NB,NC,MA,MB,MC),RETURNS(number) 

Definition  of  symbols.  ! 

I 

(See  Section  5.20)  j 


5.22 SUBROUTINE  MINV . 

The  subroutine  MINV  F)erforms  the  Inversion  of  a square, 
non-singular  matrix  of  maximum  size  10  x 10.  If  the  matrix  Is 
not  square,  singular,  or  too  big,  the  routine  Is  aborted. 


C 
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I Calling  sequence. 

( CALL  MINV(A,B,N,M),RETURNS(nuraber) 

Definition  of  symbols.  I 

A(10,10)  = Input  matrix 

B(10,10)  = Inverted  output  matrix  i f 

, N = Number  of  rows  in  A and  B | 

;«  M = Number  of  columns  in  A and  B 

r Number  = The  statement  number  in  the  calling  program  to 

' which  control  should  be  returned  if  the  routine  ' j 

i'  aborts.  ' 


5.23  SUBROUTINE  TRANPOS. 

The  subroutine  TRANPOS  transposes  (exchanges  rows  and 
columns)  the  matrix  A to  form  C. 

Calling  sequence. 

CALL  TRANPOS(A,C,NA,MA,NC,MC) 

Definition  of  symbols. 

A(10,10)  = Input  matrix  of  maximum  size  10  x 10 
C(l0,10)  = Transposed  output  matrix 
NA,NC  = Number  of  rows  in  A and  C 
MA,MC  = Number  of  columns  in  A and  C 


5.24  SUBROUTINE  MATIN. 

The  subroutine  MATIN  is  an  input  routine  which  interactively 
requests  the  input  of  a matrix  one  row  (or  column)  at  a time. 

Calling  sequence. 

CALL  MATIN( AMAT , NA , MA , NAME) , RETURNS( input ) 

Definition  of  symbols. 

AMAT(10,10)  ® Matrix  to  be  input 
NA  = Number  of  rows  in  AMAT 
MA  « Number  of  columns  in  AMAT 
NAMS  * Alphanumeric  name  of  matrix  to  be  input 
Input  = Statement  number  in  calling  program  to  which  control 
is  tO(  be  returned  if  the  subroutine  RE<\DS  requests 
an  Interrupt  to  call  calculator  or  HELP. 

Subprograms  used. 


i 
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5.25  SUBROUTTNR  PllQFS. 


The  subroutine  PHOFS  uses  Leverrler's  Algorithm  to 
compute  adj(sl  - a)  and  det(sl  - A).  If  the  input  A matrix 
is  not  square  the  routine  is  aborted. 

Calling  sequence. 

CALL  PHOFS (A , NA , , DET) , RETURNS (number) 

COMMON  statements  used. 

COMMON/A  D JNT/ AD J (10,10,10) 

Definition  of  symbols. 

A(10,10)  = A square  input  matrix 
NA  * Number  of  rows  in  A 
MA  = Number  of  columns  in  A 

DET(ll)  = Array  of  coefficients  of  the  polynomial  det(sl  - A) 
where  DET(l)  is  the  lowest  order  coefficient 
ADJ(10,10,10)  = Adjoint  matrix  adj(sl  - A)  where  the  first 
two  indices  define  the  row  and  column 
number  of  each  matrix  element  and  the  third 
is  an  index  on  the  polynomial  coefficients 
of  each  element 

Number  = Statement  number  in  calling  program  to  which  contol 
is  to  be  returned  if  the  routine  is  aborted. 

Subprograms  used. 


MMPY 


5.26  SUBROUTINE  MMPY. 

The  subroutine  MMPY  is  a special  matrix  multiply  routine 
used  by  PHOFS  and  EXPAND.  It  multiplies  matrices  A and  B 
and  stored  the  product  in  C. 

Calling  sequence. 

CALL  MMPY(A,B,C,M,K,N) 

Definition  of  symbols. 

A(M,K) , B(K,N)  Input  matrices 
C(M,N)  Output  Product  Matrix 

M,K,N  Matrix  dimensions 


5.27  SUBROUTINE  CADJB. 

The  subroutine  CADJB  computes  the  polynomial  G(s)  from 
the  matrix  product  (C)T(adj(sI  - A))B,  where  the  adjoint 
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matrix  is  supplied  as  ADJ(10, 10, 10) . 

CalllnR  sequence. 

CALL  CADJB(C,B,G) 

COMMON  statements  used. 

COMMON/ADJ(l 0,10,10) 

Definition  of  symbols. 

C(10)  = Input  6 vector 
B(10)  = Input  b vector 

ADJ(i0, 10, 10)  = Input  matrix  containinp,  adj(sl  - A) 

G(10)  = Output  array  of  polynomial  coefficients  of  the 
g forrai  07  j 

G(l)s  + G(2)s°  + G(3)s  ♦ . . . ♦ G(8)s'^  ♦ G(9)s  + G(10) 

Notes . 

(1)  The  subroutine  PHOFS  (or  its  equivlent)  must  be  called 
prior  to  callina CADJB  to  define  the  values  of 
ADJdO.lO.lO).  ^ 


5.28  FUNCTION  FW. 

The  function  FW  caluclates  the  discrete  or  continuous 
open  or  closed-loop  frequency  response  magnitude  in  linear 

magnitude  or  decibels  for  a given  frequency  in  hertz  or  radians 
per  second, 

CallinR  sequence. 

F * FW(W) 

COMMON  statements  used. 

COMMON/TOTLll/OLNPOLY(51).  OLDPOLY(51),  OLZ ERO(50, 2) , 
OLPOLE(50,2) 

♦NOLZ , NOLP, OLK, OLNK, OLDK 

C0MM0N/T0TL12/CLNP0LY(51),  CLDP0LY(51),  CLZERO(50,2) 

CLPOL  Ev  "^0 » 2 ) 

♦NCLZ , NCLP , CLK , CLNK, CLDK 
CO.MMON/DIGIT/TSAMP 

COMMON/LOGIC 2 /CLOSED,  DECIBEL,  HERTZ,  DEGREE 
Definition  of  symbol s . 


NOLZ  ■ Degree  of  OLNPOLY  polynomial 
NOLP  « Degree  of  OLDPOLY  polynomial 
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NCLZ  = Denree  of  CLNPOLY  polynomial 
NCLP  * Dogree  of  CLDPOLY  polynomial 

W = Frequency  at  which  the  response  magnitude  Is  to  be 
evaluated.  If  HERTZ  = .TRUE.,  this  frequency  Is 
assumed  to  be  In  hertz.  If  not,  the  value  of  W Is 
assumed  to  be  In  rad/sec. 

All  other  variables  are  defined  in  Section  4 of  the 
User's  Manual  for  TOTAL. 


5.29  FUNCTION  AW. 

The  function  AW(W)  Is  Identical  to  FW  (see  Section  5.28) 
except  that  the  value  returned  Is  the  phase  anp.le  of  the 
discrete  or  continuous  open  or  closed-loop  transfer  function 
frequency  response. 


5.30  SUBROUTINE  READS. 

The  subroutine  REtXDS  Is  an  elaborate  Interactive  Input 
routine  which  provides  complete  error  protection  and  recovery 
and  allows  the  user  to  retain  control  of  the  calling  program 
even  when  It  Is  awaiting  some  numerical  data  Inouc.  It  Is 
designed  to  be  used  In  place  of  the  standard  FORTRAN  READ 
statement  whenever  any  Input  Is  needed. 

Calllnp  sequence. 

CALL  READS(DATN,NO),  RETURNS ( INRUPT, REPEAT) 

common  statements  used. 

COMMON /TOTLl 6 /X,Y,Z,T  REG(20) 

COMMON /TOTLl 7/MCOMM(100) , DATM(IOO) ,MPT 

COMMON /TOTLl 8 /NRPT , NROUTE( 1 0) , NPT 

Definition  of  symbols. 

DATN(60)  » Array  In  which  Input  numbers  received  are 
returned  to  the  cal I Irg  program. 

NO  ■ Number  of  Input  numbers  that  READS  Is  supposed  to 
obtain  before  returning  control  to  the  calling 
program. 

INRUPT  » Actual  numerical  statement  number  In  the  calling 
program  to  which  control  Is  to  be  returned  If  the 
user  requests  a temporary  Interrupt  (or  complete 
abort)  from  entering  data  by  typing  a "C", 

or  (See  Note  (1)  below.) 
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REPEAT  = Actual  numerical  statement  number  in  the  calling 
program  of  the  user  prompt  statement  which 
printed  the  request  for  input  prior  to  calling 
READS.  This  feature  allows  READS  to  repeat  user 
prompts  when  necessary  (after  any  interrupt)  by 
temporarily  returning  control  to  the  calling 
program. 

XiY,Z,T  REG(20)  = Variables  in  COMMON  from  which  the  user 

can  tell  READS  to  get  a requested  piece 
of  data  instead  of  typing  the  number 
Itself.  (See  Note  (1)  below.) 

MCOMM(IOO) ,DATM,MPT  * Optional  variables  which  may  contain 

a sequence  of  commands  to  be  executed 
by  the  calling  program  where  MPT  is 
the  index  number  of  the  command 
currently  being  executed.  The  only 
thing  READS  does  with  these  variables 
is  set  them  to  zero  if  the  user 
requests  a complete  abort  with  a "$". 
(See  Note  (1)  below.) 

NPT  = Number  of  variables  which  have  been  currently  input 
by  the  user.  When  NPT  = NO,  READS  has  completed  its 
task  and  returns  control  normally  to  the  statement 
immediately  following  the  CALL  READS  statement  in 
the  main  program. 

NROUTE(IO)  = Array  used  by  the  "standard  interrupt  routine" 
(See  Note  (2;)  to  specify  the  code  number  for 
the  routine  to  be  called  in  the  main  program 
during  a temporary  interrupt  request  by  the 
user. 

NROUTE(l)  =8  if  the  user  types  a "C"  interrupt  request 
=9  if  the  user  types  a "?"  Interrupt  request 

NRPT  = Index  on  NROLITE(NRPT)  which  is  set  equal  to  1 
• during  an  Interrupt  request . 


Notes . 

(1)  When  input  is  requested  by  READS  the  user  mayj 

Enter  the  requested  numbers  or 

Type  "C"  to  request  a temporary  return  to  the  calling 

program  at  statment  number  INRUPT.  NROUTE  (1) 
is  set  to  8 to  indicate  that  this  is  a "C" 
Interrupt.  This  function  is  designed  to  allow 
the  user  to  temporarily  jump  to  a calculator 
routine  from  the  middle  of  inputting  data 
(although  it  can  be  used  for  any  kind  of 
Interrupt  desired) . 

Type  "?"  to  request  a tempory  return  to  the  calling 

program  at  statement  number  INRUPT.  NROUTE(l) 
Is  set  to  9 to  indicate  that  this  is  a "?" 
Interrupt.  This  function  is  designed  to  allow 
the  user  to  temporarily  Jump  to  a help  routine 
for  explanation  of  the  input  needed  (although 
It  can  be  used  for  any  kind  of  interrupt 
desired.) 
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to  list  the  current  values  of  the  requested  | 

variables.  The  first  NO  elements  of  the 
DATN  array  are  listed. 

to  leave  the  current  value  of  a requested 
variable  unchanged.  NPT  is  incremented  by  , 

one  and  READS  waits  for  the  next  number  in  , 

the  sequence.  (If  NPT  = NO,  RE<\DS  ends.)  . 

to  completely  abort  not  only  the  current  j 

input  of  data  but  also  the  current  option 
being  executed  and  any  additional  options 
which  may  have  been  stored  in  the  MCOMM  and 
DATM  arrays  awaiting  execution, 
or  ••Y",”Z’',"T",  or  ''Rl"  through  ”R20"  to  tell 
READS  to  get  the  current  number  being  requested 
from  the  corresponding  variable  in  labeled  ! 

COMMON  X,  Y,  L,  T,  or  REG(l)  through  REG(20)  j 

respectively.  REtXDS  stores  the  specified  I 

value  into  DATN ( NPT ) , increments  NPT,  and 
looks  for  the  next  requested  value.  If  NPT  = NO,  \ 
READS  ends.  \ 

to  "Pn"  to  set  NPT  equal  to  any  number  between  i 
1 and  n = NO.  This  allows  the  user  to  skip  } 

around  in  list  of  variables  requested  to  enter  < 

only  certain  variables  or  to  modify  the  values 
of  variables  already  input.  When  Pn  is  typed, 

READS  waits  for  the  user  to  specify  the  value 
of  the  n ch  variable  and  then  continues  to 
increment  NPT  from  that  point . 

^ (2)  The  subroutine  REilDS  initiates  what  is  called  the 

"standard  interrupt  routine"  for  whatever  program  calls 
it  whenever  a user  types  a "C",  "?"  or  . This 
interrupt  routine  is  just  a sequence  of  commands  stored 
in  the  array  NROUTE  which  direct  the  flow  of  the  calling  j 
program  until  the  interrpution  has  ended.  It  works 
as  follows i When  READS  encounters  an  interrupt  ! 

character,  it  stores  the  code  number  of  the  program  | 

which  is  to  be  called  in  NROUTE(l),  sets  the  pointer  i 

NRPT  = 1 and  returns  control  to  statement  number  INRUPT  • 

in  the  calling  program.  This  statement  then  stores  j 

the  code  number  for  the  program  which  contains  it  in  | 

NR0LITE(2)  and  returns  control  to  the  main  executive  | 

overlay.  The  executive  sees  that  NRPT  * 1,  so  it 
calls  whatever  program  has  been  specified  in  NROUTE(l) 
and  increments  NRPT.  When  the  program  called  has 
finished  executing  the  executive  calls  the  program 
specified  in  NR0UTE(2)  which  in  turn  calls  the 
subroutine  READS  again  and  the  interrupt  procedure  is 
over.  READS  then  repeats  the  prompt  to  the  user  and 
all  data  that  had  been  entered  prior  to  the  Interrupt 
(as  a reminder)  and  waits  for  the  user  to  enter  the 
remaining  data  (or  request  another  Interrupt) . 

O 
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Type  "L" 
Type 

Type  "$" 

Type  "X" 

Type  "PI" 


1.  AFIT/EN.  ROOTL  User*  s Manual . Wright-Patterson  Air  Force 
Base,  Ohioj  Air  Force  Institute  of  Technology,  March  1975. 


2.  AFIT/EN.  PARTL . Heaviside  Partial  Fraction  Expansion  and 
Time  Response  Propram.  (Revised)  Wright-Patterson  Air 
Force  Base,  Ohioi  Air  Force  Institute  of  Technology,  March 
1975. 
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Appendix  C 

C 

This  appendix  Is  Intended  to  provide  suppllmental 
Information  on  the  program  READER  which  is  discussed  in 
Section  4.15  of  Appendix  B.  Its  purpose  Is  to  describe  how 
READER  handles  a line  of  Input  data  and  how  It  Interprets 
each  character  It  encounters  In  the  line. 

: . I 

i-: 

•I 

How  Input  Is  Received 

READER  reads  an  80  character  line  Into  an  array  of  80 
words  called  IN(80)  using  a right  justified,  zero-fill 
hollerlth  (Rl)  format.  This  means  that  each  60  bit  word  In 
the  array  Is  filled  with  zeros  except  for  the  six  least 
^ significant  bits  which  contain  the  display  code  of  a given 

character  In  the  line.  (A  display  code  number  Is  just  an 
Integer  from  0 to  63  corresponding  to  one  of  the  64  possible 
characters  which  may  be  typed  from  the  user's  keyboard.  For 
example,  the  letter  "L"  has  a display  code  of  13  and  is 
represented  by  the  six  binary  digits t 001101.)  Using 
this  technique,  a line  of  80  keyboard  characters  Is  stored  In 
an  array  80  words  long  as  a sequence  of  numbers  between  0 and 
63.  READER  Is  then  able  to  operate  on  this  array  of  numbers 
using  a compiler  code. 
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READER’S  ConiDller  Code 

The  compiler  code  used  by  READER  Is  shown  In  Fig.  1.  It 
consists  simply  of  an  array  of  binary  data  64  words  long  which 
defines  the  meaning  of  each  of  the  64  keyboard  characters  in 
up  to  20  different  situations  (modes  of  operation)  in  the 
program. 

The  code  works  like  thisi  Associated  with  each  keyboard 
character  there  is  a 60  bit  word  of  coded  information  stored 
in  the  array  A.  If  the  binary  number  represented  by  these 
60  bits  is  written  in  octal  (base  8),  the  resulting  form  is  a 
20  digit  string  of  digits  between  0 and  7.  If  each  of  these 
digits  is  considered  as  a piece  of  infornation  (i.e.  a number 
between  0 and  7),  then  each  word  in  the  array  A can  store  20 
pieces  of  information  about  Its  corresponding  keyboard 
character.  This  information  can  therefore  be  used  to  tell  the 
compiler  how  to  treat  a particular  character  in  20  different 
situations. 


How  the  Code  is  Used 

At  this  point  it  may  be  helpful  to  give  the  reader  an 
example  of  how  a keyboard  character  can  have  different  meanings 
in  different  situations.  Suppose,  for  example,  that  the 
compiler  is  operating  on  a sting  of  keyboard  characters  which 
are  intended  to  represent  a floating  point  number.  If  any 
character  other  than  0,  1,  2,  3,  4,  5,  6,  7,  8,  9,  ♦,  -,  or 
Is  encountered,  the  compiler  may  assume  that  the  current 
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A<L) 


A(L) 


1 11111111141114444166  : 

2 11111111141114444111  A 

3 11111111141114444111  B 

4 11111111141114444111  C 

5 11111111141114444111  D 

6 11111111141114433111  E 

7 11111111141114444111  F 

8 11111111141114444111  G 

9 11111111141114444111  H 

10  11111111141114444111  I 

11  11111111141114444111  J 

12  11111111141114444111  K 

13  11111111141114444111  L 

14  11111111141114444111  M 

15  11111111141114444111  N 

16  11111111141114444111  0 

17  11111111141114444111  P 

18  11111111141114444111  a 

19  11111111141114444111  R 

20  11111111141114444111  S 

21  11111111141114444111  T 

22  11111111141114444111  U 

23  11111111141114444111  V 

24  11111111141114444111  U 

25  11111111141114444111  X 

26  11111111141114444111  Y 

27  11111111141114444111  Z 

28  22222222222222222222  0 

29  22222222222222222222  1 

30  22222222222222222222  2 

31  22222222222222222222  3 

32  22222222222222222222  4 


22222222222222222222 

22222222222222222222 

11111111141114244132 

11111111141114244132 

11111111141114444136 

11111111141114444136 

11111111141114444166 

11111111111114444166 

11111111141114444144 

11111111141114444166 

11111111131115555166 

11111111131115555166 

11111111141114441122 

11111111141114444133 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444144 

11111111141114444166 

11111111141114444166 

11111111141114444166 

11111111141114444155 

11111111141114444155 

11111111141115555166 

77777777757776666777 


Fig.  1 READER'S  Compiler  Code 
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number  has  terminated  and  subsequent  characters  belong' to  some 
other  input  item.  As  long  as  each  new  character  examined  is 


0 through  9,  this  condition  will  hold  true.  However,  after  a | 

decimal  point  has  been  encountered,  further  decimal  points  are  * 

not  allowed  and  the  meaning  of  the  character  must  be 
changed  from  "decimal  point"  to  "error  --  too  many  decimal 
points." 

To  implement  the  above  simple  example,  two  different 
meanings  must  be  defined  for  the  character  ".".  These 

meanings  can  be  coded  as  two  different  numbers  in  two  of  the  i 


20  possible  entries  in  the  element  of  the  A array  which  i 

corresponds  to  the  character  j 

I 

What  this  means  is  that  the  64  keys  can  be  divided  into  ' 

up  to  seven  groups  by  each  of  the  20  columns  of  numbers  stored  j; 

in  the  A array.  When  a particular  column  is  selected,  the 
value  of  the  number  in  that  column  corresponding  to  a 
particular  character  is  the  group  to  which  that  character 

belongs  in  the  column.  For  example,  in  Fig.  1,  the  number  3 ' 

i 

appears  in  the  second  column  of  a(L)  (from  the  right)  across 
from  the  keyboard  characters i ♦,  -,  *,  /,  and  #.  Thus,  these 

i 

five  characters  belong  to  the  same  group  when  column  two  is  ( 

selected.  In  the  same  column,  the  number  2 appears  across  from 
the  keys  0,  1,  2,  3,  4,  5,  6,  7,  8,  9,  and  "."  placing  them  in 
another  group. 


Continuing  with  the  example  of  reading  a floating  point 
number,  it  is  desired  to  divide  the  possible  characters  into 


groups  of  valid  number  characters,  valid  number  terminating 
characters,  and  illegal  characters  to  be  flagged  as  input 
errors.  The  fourth  column  of  the  A array  makes  such  a 
division,  as  show  belowi 


PARTITION  PERFORMED  BY  COLUMN  4 

Number  in  Characters  assigned 

column  4 to  that  number  ] 

1 decimal  point  I 

2 0123456789  I 


Meaning  of 

the  group  of  characters 


Legal  decimal  point 
Legal  digit 
Exponent  of  number 
Illegal  characters 


4 Letters  and  special  Illegal  characters 

characters  not  in 

any  other  group 

5 blank,  comma,  semicolon  Valid  number  terminates 
When  the  first  character  of  a number  is  encountered 

in  the  input  string,  the  compiler  goes  to  "mode  4”  and  reads 

subsequent  characters  using  the  partition  of  column  4.  If 

the  next  character  encountered  is  in  group  2,  it  is  accepted 

as  a legal  digit,  the  compiler  remains  in  mode  4,  and  moves 

on  to  the  next  character.  If  a character  in  group  4 is  found, 

it  is  not  accepted  and  an  error  message  is  given.  If  the 

character  belongs  to  group  1 (in  this  case  it  is  a decimal 

point(  the  point  is  accepted  as  a legal  part  of  the  number, 

but  the  compiler  shifts  into  mode  5 before  continuing  to  the 

next  character.  Mode  5 is  just  another  partition  of  characters, 

% 

this  time  as  defined  by  column  5 of  the  A array.  The  new 
partition  is  identical  to  the  old  except  that  the  character 

has  been  moved  from  group  1 (where  it  meant  “decimal  point") 
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to  group  4 (where  it  means  "illegal  character").  For  the 
remainder  of  the  current  number,  the  compiler  never  returns 
to  mode  4 and  a second  decimal  point  remains  illegal.  Similar 
modes  are  defined  by  other  columns  to  allow  the  characters 
"♦"  and  at  the  beginning  of  a number  or  just  following 
the  letter  "E"  in  the  exponent  but  no  where  else,  and  so  on. 

Numbers  are  obtained  from  a particular  column  by  masking 
out  everything  except  the  six  bits  in  the  column  of  interest. 
These  bits  are  then  converted  to  their  decimal  equivalent  and 
stored  in  the  variable  LGO  for  for  use  in  a computed  GO  TO 
statement.  Statements  205  and  260  in  READER  perform  such 
operations. 
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